Skip to main content
HTML Elements

<link>

HTML element · 4 supported, 0 partial, 11 unsupported across 15 clients

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
Apple MaildesktopWebKitSupported
Apple Mail iOSmobileWebKitSupported
Yahoo MailwebmailYahooUnsupported
Samsung MailmobileSamsungUnsupported
ThunderbirddesktopGeckoUnsupported
HEY MailwebmailWebKitUnsupported
SuperhumandesktopBlinkUnsupported

Client-by-client behaviour for <link>

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

No support (11): Gmail, Gmail Android, Gmail iOS, Outlook 365, Outlook iOS, Outlook Android, Yahoo Mail, Samsung Mail, Thunderbird, HEY Mail, 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

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Gmail Android

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Gmail iOS

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Outlook 365

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Outlook iOS

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Outlook Android

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Yahoo Mail

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Samsung Mail

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Thunderbird

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

HEY Mail

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Superhuman

Unsupported

Inline all CSS directly in the HTML.

Before

<head>
  <link rel="stylesheet" href="styles.css" />
</head>

After

<head>
  <style>
    /* Paste your CSS here, or use a build tool like
       juice/inline-css to inline automatically */
    .container { max-width: 600px; margin: 0 auto; }
    .header { background-color: #6d28d9; padding: 32px; }
  </style>
</head>

Inline all CSS instead of using external stylesheets

Production guidance for <link>

<link> is a HTML element. Across the email client matrix, 4 of 15 tracked clients support it fully, 0 only partially, and 11 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

Test your email across all 15 clients

Preview rendering, catch CSS issues, and get actionable fixes — free.

Try Emailens Free

Support data last updated Apr 27, 2026 · synced from caniemail.com via @emailens/engine.