Skip to main content
Emailens
HTML Elements

<link>

HTML element · 5 supported, 0 partial, 16 unsupported across 21 clients

As of Sep 2, 2026, <link> fails or degrades in 16 of 21 email clients, treat it as progressive enhancement, never structure.

  • 0/7 webmail, 4/6 desktop, 1/8 mobile clients support <link> fully.
  • Unsupported in Gmail, Gmail Android, Gmail iOS, Outlook 365 and 12 more.
  • Documented before/after fixes on this page cover 21 clients, including Gmail and Gmail Android.
  • Across all clients, only 6 of 298 tracked HTML/CSS features render identically everywhere.

Source: caniemail.com (MIT), via the Emailens engine. Last tested upstream Dec 21, 2023, synced by Emailens Sep 2, 2026.

Client Support

ClientCategoryEngineSupport
GmailwebmailGmail WebUnsupported
Gmail AndroidmobileGmail MobileUnsupported
Gmail iOSmobileGmail MobileUnsupported
Outlook 365webmailOutlook WebUnsupported
Outlook (New)desktopOutlook WebSupported
Outlook ClassicdesktopMicrosoft WordSupported
Outlook iOSmobileOutlook MobileUnsupported
Outlook AndroidmobileOutlook MobileUnsupported
Outlook for MacdesktopWebKitSupported
Apple MaildesktopWebKitSupported
Apple Mail iOSmobileWebKitSupported
Yahoo MailwebmailYahooUnsupported
Yahoo Mail AndroidmobileYahooUnsupported
Yahoo Mail iOSmobileYahooUnsupported
Samsung MailmobileSamsungUnsupported
ThunderbirddesktopGeckoUnsupported
HEY MailwebmailWebKitUnsupported
Proton MailwebmailProtonUnsupported
AOL MailwebmailAOLUnsupported
FastmailwebmailFastmailUnsupported
SuperhumandesktopBlinkUnsupported

Client-by-client behaviour for <link>

Fully supports <link> (5): Outlook (New), Outlook Classic, Outlook for Mac, Apple Mail, Apple Mail iOS.

No support (16): Gmail, Gmail Android, Gmail iOS, Outlook 365, Outlook iOS, Outlook Android, Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS, Samsung Mail, Thunderbird, HEY Mail, Proton Mail, AOL Mail, Fastmail, Superhuman. Plan fallbacks for these clients before relying on <link> in production sends.

Fixes & Workarounds

Gmail

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Gmail Android

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Gmail iOS

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Outlook 365

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Outlook iOS

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Outlook Android

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Yahoo Mail

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Yahoo Mail Android

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Yahoo Mail iOS

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Samsung Mail

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Thunderbird

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

HEY Mail

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Proton Mail

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

AOL Mail

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Fastmail

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Superhuman

Unsupported

Inline all CSS directly in the HTML.

Before (Broken)

before.html
3 lines
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After (Fixed)

fixed.html
3 lines
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>

Inline all CSS instead of using external stylesheets

Production guidance for <link>

<link> is a HTML element. Across the email client matrix, 5 of 21 tracked clients support it fully, 0 only partially, and 16 not at all. The clients most likely to require a workaround for this feature are Gmail, Gmail Android, Gmail iOS. Each of them needs a tailored fallback. See the per-client examples above for the specific code fix Emailens recommends.

When in doubt, ship a baseline that renders without <link> and treat it as progressive enhancement on clients where support is verified. Emailens automatically detects cross-client divergence on this feature when you preview an email, so you can see exactly which template paths break before a campaign goes out.

Related Features

Check your own HTML for <link>

Paste your own, or run the sample below. Analyzed in this page, with no signup and nothing stored.

Zero-Friction Engine Preview

Test your <link> layout across 21 email clients

Preview rendering, catch CSS issues, and see how <link> displays across Outlook, Gmail, and Apple Mail. Free, no account needed.

Instant live preview · No signup required · 21 email engines

Last tested upstream: · Last synced by Emailens:

caniemail.com (MIT) records Dec 21, 2023 as the last time <link> was tested in a real client, 2 years before this sync. Syncing copies that result forward, it does not re-test it. Carried in @emailens/engine data v0.12.2.