Dark mode support in email splits three ways, and only one of them is the CSS most senders design for. Some clients honor @media (prefers-color-scheme: dark) exactly as written. Others rewrite it into syntax that can never match and recolor the email themselves. A third group barely acknowledges the newer color-scheme meta tag at all. Designing for the first group alone means designing for less than half the inbox, which is why MailInApp makes every email readable in all three.
Group one: clients that honor the media query
Per caniemail.com, @media (prefers-color-scheme: dark) is listed as supported in Gmail (all platforms) and Apple Mail (macOS 12.4+ and iOS 13.0+). Outlook is close behind: Windows, macOS, Outlook.com and mobile all recognize the query, and macOS Outlook and Outlook.com also add their own dark-mode data attributes. Samsung Email (Android 6.1+) supports it too. Combined, caniemail.com's tested panel puts overall support at 41.86%, a real share of major clients but far from all of them.
In MailInApp's own tests in real inboxes (October 2026), Gmail didn't match that listing. The media query applied in Mail on iPhone and iPad, iCloud Mail on the web, Outlook.com and the Outlook apps for iOS and Android, and Outlook.com also added its [data-ogsc] and [data-ogsb] attributes. No Gmail app applied it: Gmail on the web kept the email light, the Gmail Android app partly recolored it on its own, and the Gmail iOS app inverted it fully. For planning, treat Gmail as a client that decides dark mode for you, alongside group two. We haven't measured Apple Mail on macOS, Outlook on Windows or macOS, or Samsung Email.
Group two: clients that rewrite the query so it never matches
This group produces the washed-out dark emails most senders have seen. Yahoo Mail, AOL and Fastmail rewrite prefers-color-scheme into invalid syntax (@media ( _filtered_a )) that can never be true, which switches off every rule inside it. HEY rewrites the query to @media (false). In both cases the client then applies its own automatic color inversion to the light design, which is what turns logos pale and text low-contrast, because nothing the sender wrote drives the result.
MailInApp's own tests (October 2026) match this for Yahoo Mail, which recolored the email itself. Thunderbird behaved the same way: it applies no media queries and partly recolors the email on its own.
Group three: the color-scheme meta tag, still rare
<meta name="color-scheme" content="light dark"> (and its supported-color-schemes cousin) tells a client which modes an email is designed for, so the client can skip inversion instead of guessing. It's the more precise fix, but caniemail.com puts support at only 9.76% combined. Apple Mail (macOS 16+ and iOS 12.4+), recent Outlook versions, Samsung Email 9.1 and Thunderbird 102.11 list support, and Gmail honors only the "light only" value. Most other clients ignore it.
What this means for design
No single rule covers all three groups. The dependable approach is progressive enhancement, the same principle Litmus's dark mode guide lands on:
- Design a fully readable light email first. It's the baseline every client falls back to, including group two and every Gmail app.
- Layer explicit
prefers-color-schemeoverrides on top for the roughly 42% of clients that apply them, and don't rely on the meta tag alone. - Protect logos and images from inversion. A semi-transparent PNG on white can turn unreadable in group two and in the Gmail apps. A border or a solid background behind the asset survives inversion.
- Set text colors explicitly. Auto-inversion can flip a background without flipping text the way the sender expects.
What MailInApp does about it
The studio covers all three groups without any CSS work from you:
- Dark mode setting. In the Theme panel, Auto recolors neutral text and white backgrounds with standard dark colors and keeps your brand colors. Custom uses your own dark palette, with per-block Text in dark mode and Background in dark mode and a dark version of any image. Off mails no dark styles. The settings are in Theme, phones and dark mode.
- A preview that matches real inboxes. The dark-mode toggle in the Clients preview shows each email app's dark mode as we measured it, including the apps that recolor on their own.
- Preflight warnings. The preflight checklist flags transparent PNGs without a background and dark text without a container, the two things that break under inversion, and checks contrast in light and dark.
- Measured results per app. Email client support lists where your own dark colors apply and where the app recolors the email.
Sources
- caniemail.com: @media (prefers-color-scheme)
- caniemail.com: color-scheme meta tag
- Litmus: The Ultimate Guide to Dark Mode for Email Marketers
- MailInApp: Email client support, MailInApp's own tests in real inboxes, October 2026.