OfficeDev / OfficeDev/outlook-dev-docs

Outlook OFT: Hyperlink underline color changes to blue in Outlook New and Outlook for Mac

Open
#1,076 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Needs: triage :mag:
Dominant language
No language data
Stars
99
Forks
113
PR merge metrics
No merged PRs in 30d

Description

Outlook OFT Hyperlink Underline Color Issue

We're seeing an issue when sharing email proofs using an Outlook Template File (OFT).

Expected Behavior

  • Hyperlink text color: White
  • Hyperlink underline color: White (matching the link styling defined in the HTML)

Actual Behavior

  • Hyperlink text remains white.
  • Hyperlink underline changes to the default Outlook blue color.
image

Observed In

  • Outlook New (Windows)
  • Outlook for Mac

Not Observed In

  • Outlook Classic (Windows)
  • EML-based email proofs (renders correctly across all tested Outlook clients)

Testing Performed

  • Inline link styling (color, text-decoration, text-decoration-color)
  • Global anchor styling (a, a:link, a:visited, etc.)
  • Outlook-specific styles (span.MsoHyperlink, span.MsoHyperlinkFollowed)
  • Tested with and without nested spans

The issue only occurs when the email is opened/shared through the OFT workflow. The same HTML renders correctly when distributed as an EML file.

Has anyone encountered this behavior in Outlook New or Outlook for Mac when using OFT templates? Any recommended workaround to preserve the hyperlink underline color during compose/forward from an OFT?

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

No repository file or test is identified. Start by reproducing the hyperlink behavior through the OFT workflow in Outlook New and Outlook for Mac, comparing it with EML proofs and Outlook Classic; done means identifying whether a reliable workaround preserves the underline color or documenting that the behavior is client-controlled.

Written by the indexing model from the issue text.

Assessment

Tech stack
html
Domain
documentation
Issue type
Bug
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Needs clarification
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.