HTML & Email Structure

meta-color-scheme

CSS property · 2 supported, 2 partial, 16 unsupported across 21 clients

As of Oct 14, 2026, meta-color-scheme fails or degrades in 19 of 21 email clients, treat it as progressive enhancement, never structure.

0/7 webmail, 2/6 desktop, 0/8 mobile clients support meta-color-scheme fully.
Unsupported in Gmail, Outlook 365, Outlook (New), Outlook Classic and 12 more.
Partial in Gmail Android, Gmail iOS, behavior differs from browsers, test before relying on it.
Outlook Classic (Word engine, supported to at least 2029) does not fully support meta-color-scheme, and its replacement changes little here; see the deprecation diff.
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 Sep 16, 2026, synced by Emailens Oct 14, 2026.

Client Support

Client	Category	Engine	Support
Gmail	webmail	Gmail Web	Unsupported
Gmail Android	mobile	Gmail Mobile	Partial^{See caveat 1}
Gmail iOS	mobile	Gmail Mobile	Partial^{See caveat 1}
Outlook 365	webmail	Outlook Web	Unsupported
Outlook (New)	desktop	Outlook Web	Unsupported
Outlook Classic	desktop	Microsoft Word	Unsupported
Outlook iOS	mobile	Outlook Mobile	Unsupported
Outlook Android	mobile	Outlook Mobile	Unsupported
Outlook for Mac	desktop	WebKit	Unsupported
Apple Mail	desktop	WebKit	Supported
Apple Mail iOS	mobile	WebKit	Unsupported
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	Supported
HEY Mail	webmail	WebKit	Unsupported
Proton Mail	webmail	Proton	Unsupported
AOL Mail	webmail	AOL	Unsupported
Fastmail	webmail	Fastmail	Unsupported
Superhuman	desktop	Blink	Unknown

Documented caveats (1)

1.Gmail Android, Gmail iOS: Partial support. Only the value light only is supported (see Google IssueTracker.

Caveats recorded by caniemail.com (MIT) and carried verbatim, one entry per wording rather than per client.

Client-by-client behaviour for meta-color-scheme

Fully supports meta-color-scheme (2): Apple Mail, Thunderbird.

Partial support (2): Gmail Android, Gmail iOS. Expect rendering quirks unique to each engine. Partial support typically means a subset of values, an ignored shorthand, or sanitizer-specific rewrites.

No support (16): Gmail, Outlook 365, Outlook (New), Outlook Classic, Outlook iOS, Outlook Android, Outlook for Mac, Apple Mail iOS, Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS, Samsung Mail, HEY Mail, Proton Mail, AOL Mail, Fastmail. Plan fallbacks for these clients before relying on meta-color-scheme in production sends.

Behaviour unverified in: Superhuman.

When to use meta-color-scheme in email

Declaring dual-theme compatibility at the document head to activate native dark mode rendering in Apple Mail and webmail.
Eliminating the bright white canvas flash when recipients open dark-themed emails in dark-mode clients.
Working in tandem with CSS color-scheme and media queries to establish an end-to-end dark mode protocol.

Rendering behaviour and edge cases

Apple Mail on macOS reads <meta name="color-scheme"> to adapt the background frame; iOS Mail historically requires <meta name="supported-color-schemes"> alongside CSS :root color-scheme.
Outlook desktop and webmail strip <meta> tags from the document head during message sanitization.
Gmail webmail strips custom <meta> tags in <head>, applying dark mode based on its own webmail interface settings.

Recommended fallback strategy

Include both <meta name="color-scheme" content="light dark"> and <meta name="supported-color-schemes" content="light dark"> inside <head>. Mirror the directive with :root { color-scheme: light dark; } in your primary <style> block.