You can finally stop Gmail from forcing dark mode on your emails.
Short answer: The Gmail apps for iOS and Android now respect the color-scheme meta tag. Add <meta name="color-scheme" content="light only"> to stop Gmail forcing dark mode on your emails. Then add :root { color-scheme: light dark; } in your CSS so your custom dark mode styles keep working in clients like Apple Mail.*
*Note: This is only needed if a user is setting custom dark mode styles, (@media { prefers-color-scheme: dark; }). Otherwise, it can be left out as it might make your previews wonky depending on what your system colour preferences are set to.
Forced dark mode in the Gmail app has been one of the biggest headaches in email design. Gmail would invert your colors on its own terms, and there was nothing you could do to stop it. That just changed. Here's what's new, how to use it, and the one gotcha to watch out for that could still break your dark mode in other clients.
What changed in the Gmail app?
Gmail for iOS and Android now honors the color-scheme meta tag. Until now, both apps ignored it and applied their own color inversion whenever a user had dark mode enabled on their device. Light backgrounds went dark, dark text went light, and brand colors often came out wrong.
The fix was a long-standing request on Google's own issue tracker. Email developers can now tell Gmail to leave their design alone and honor the intended design system.
How do you stop Gmail forcing dark mode?
Add this meta tag to the <head> of your email:
<meta name="color-scheme" content="light only" /> That tells Gmail your email only supports a light color scheme, so the app shows it exactly as designed. No more surprise inversions.
The catch: your custom dark mode can stop working
Note that light only isn't just read by Gmail. Other clients that support color-scheme, like Apple Mail, read it too.
If you've written your own dark mode styles with @media (prefers-color-scheme: dark), those clients will now skip them. You've told them the email is light only, so they take that literally.
The result: Gmail is fixed, but your carefully built dark mode disappears everywhere else.
The fix: reset color-scheme in your CSS
Keep the meta tag for Gmail, then reset the color scheme in your CSS:
:root { color-scheme: light dark; }
The meta tag blocks Gmail's forced dark mode conversion. The CSS tells clients like Apple Mail that your email supports both schemes, so your prefers-color-scheme: dark styles run again.
Here's how it fits together:
<head> <meta name="color-scheme" content="light only" /> <style> :root { color-scheme: light dark; } @media (prefers-color-scheme: dark) { .email-body { background-color: #121212 !important; } .email-text { color: #f5f5f5 !important; } } </style> </head>
The result: Gmail shows your light design as built, and clients that support custom dark mode get your dark styles. Test in both Gmail apps and Apple Mail before you send.
FAQ
Does Gmail support the color-scheme meta tag? Yes. The Gmail apps for iOS and Android now respect <meta name="color-scheme" content="light only">, which stops forced dark mode.
How do I prevent dark mode in Gmail emails? Add <meta name="color-scheme" content="light only" /> to your email's <head>. Gmail will display your email in its original light design.
Why did my dark mode styles stop working in Apple Mail? Apple Mail also reads light only, so it ignores your prefers-color-scheme: dark media queries. Add :root { color-scheme: light dark; } to your CSS to turn them back on.
Can I block Gmail dark mode and keep custom dark mode elsewhere? Yes. Use the light only meta tag for Gmail and the color-scheme: light dark CSS reset for everything else.
Does this affect Gmail on desktop? This update covers the Gmail iOS and Android apps, where forced dark mode was the problem.
Anything else I should keep in mind? Your recipients may be surprised to suddenly see an email that bypasses their preferences. They may assume your email was an image, or that you bypassed accessibility standards. We recommend being cautious about bypassing dark mode in their inbox.
Why doesn't the color-scheme fix show up in Litmus? In our testing, Litmus Gmail app previews still showed forced dark mode, while real sends to the Gmail app worked. It may only apply to Google accounts, but that's unconfirmed. Test with a real send to verify.
