<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
| Client | Category | Engine | Support |
|---|---|---|---|
| Gmail | webmail | Gmail Web | Unsupported |
| Gmail Android | mobile | Gmail Mobile | Unsupported |
| Gmail iOS | mobile | Gmail Mobile | Unsupported |
| Outlook 365 | webmail | Outlook Web | Unsupported |
| Outlook (New) | desktop | Outlook Web | Supported |
| Outlook Classic | desktop | Microsoft Word | Supported |
| Outlook iOS | mobile | Outlook Mobile | Unsupported |
| Outlook Android | mobile | Outlook Mobile | Unsupported |
| Outlook for Mac | desktop | WebKit | Supported |
| Apple Mail | desktop | WebKit | Supported |
| Apple Mail iOS | mobile | WebKit | Supported |
| Yahoo Mail | webmail | Yahoo | Unsupported |
| Yahoo Mail Android | mobile | Yahoo | Unsupported |
| Yahoo Mail iOS | mobile | Yahoo | Unsupported |
| Samsung Mail | mobile | Samsung | Unsupported |
| Thunderbird | desktop | Gecko | Unsupported |
| HEY Mail | webmail | WebKit | Unsupported |
| Proton Mail | webmail | Proton | Unsupported |
| AOL Mail | webmail | AOL | Unsupported |
| Fastmail | webmail | Fastmail | Unsupported |
| Superhuman | desktop | Blink | Unsupported |
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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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
UnsupportedInline all CSS directly in the HTML.
Before (Broken)
<head>
<link rel="stylesheet" href="styles.css" />
</head> After (Fixed)
<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.
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.