Gmail finally lets you opt out of forced dark mode. Should you?
The Gmail apps now honor color-scheme "light only". When blocking dark mode helps, when it hurts, and the Apple Mail catch.
For years, the Gmail apps on iOS and Android ignored every signal you gave them about color and inverted your email whenever the phone was in dark mode. That has changed. A fix for a roughly five-year-old Google issue tracker ticket was marked done on August 31, and the apps now honor one value of the color-scheme meta tag.
What changed
Add this to the email's <head> and the Gmail apps stop applying forced dark mode:
<meta name="color-scheme" content="light only" />
It applies to email received in Google accounts (gmail.com and Workspace). Third-party accounts opened in the Gmail app are not covered.
The Apple Mail catch
Apple Mail also reads light only, and then skips your @media (prefers-color-scheme: dark) styles. If you've built custom dark styles, reset it in CSS:
:root {
color-scheme: light dark;
}
When blocking makes sense
- Dark-designed emails that iOS Gmail turns light by inverting luminance.
- Brand-critical colors, such as a product shot or a logo on a colored band, that inversion ruins.
When it doesn't
Blocking overrides what your reader chose. If Gmail's automatic conversion already looks acceptable, leave it alone. The better long-term fix is designing for dark mode: prefers-color-scheme styles, light-dark() where supported, and <picture> swaps for images.
Test with real sends
Dyspatch found that Litmus's Gmail previews still showed forced dark mode while real sends worked. Until preview tools catch up, check on a real device with a Google account.
For agency template systems
- Block Gmail dark mode.
- Block it, but keep custom dark styles in other clients.
- Leave the default behavior.
Make it a per-template setting rather than a global default.
Sources
- Email Markup Consortium (opens in a new tab) (September 21, 2026)
- Dyspatch (opens in a new tab) (October 8, 2026)