Skip to main content

Our email CSS engine is open source. Give it a star on GitHub 

Emailens

<link> in Gmail iOS

Not supported <link> is not supported in Gmail iOS.

Works in 3 of 21 · not supported in 18

Which clients
Works
Outlook Classic, Apple Mail, Apple Mail iOS
Not supported
Gmail, Gmail Android, Gmail iOS, Outlook 365, Outlook (New), Outlook iOS, Outlook Android, Outlook for Mac, Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS, Samsung Mail, Thunderbird, HEY Mail, Proton Mail, AOL Mail, Fastmail, Superhuman

Your reader in Gmail iOS sees the email without <link>, even if it looks right where you tested it.

The fix for Gmail iOS

Inline all CSS instead of using external stylesheets

The engine still flags this in the fix: Gmail iOS inverts every colour in dark mode, dark backgrounds included: #6d28d9 and the other dark backgrounds turn light, and their light text turns dark. It ignores @media (prefers-color-scheme: dark), so CSS cannot opt out.

after
<div style="max-width: 600px; margin: 0 auto;">
  <div style="background-color: #6d28d9; padding: 32px;"></div>
</div>
Show the original
before
<head>
  <link rel="stylesheet" href="styles.css" />
</head>

The checker needs a computer screen.

A free account opens all 21 clients and keeps your checks for 7 days. Create a free account →

What Gmail iOS does with <link>

@emailens/engine 0.18.22 on the original code

Gmail iOS does not support external stylesheets.

Your next question

Every feature in Gmail iOS · <link> in every client

Questions

How many email clients support <link>?
It works in 3 of 21, not supported in 18.
What do I use instead of <link> in Gmail iOS?
Inline all CSS instead of using external stylesheets.
Does <link> work in Gmail Android?
<link> is not supported in Gmail Android. Closest to Gmail iOS: Gmail Android, which agrees on 273 of the 300 features both are tested on.

To see what else in your email Gmail iOS does not support, paste the whole email.

The checker needs a computer screen.

caniemail (MIT) via @emailens/engine 0.18.22 · tested upstream 21 Dec 2023 · data last changed 10 Nov 2026 · Outlook (New) cells are the engine's mapping