All articles

Gmail's apps now honor light only, so here's how to use it

The Gmail iOS and Android apps have started respecting the color-scheme meta tag set to light only. Here is what changed, what is still unconfirmed, and how I am testing it before rolling it into client templates.

For years, the Gmail apps on iOS and Android have done their own thing with dark mode. If a subscriber had dark mode switched on, Gmail inverted your colors whether you liked it or not, and there was no reliable way to opt out. That changed recently. On August 31, 2026, a long-standing Google Issue Tracker ticket asking Gmail to support the color-scheme meta tag was marked as fixed, with a note that the fix was rolling out in an upcoming release. Since then, email platforms and developers have been reporting that the Gmail apps now respect color-scheme when it is set to light only.

It has been a quiet week for email rendering news, so I want to come back to this one. It is the most useful dark mode change I have seen in a long time, and I think a lot of teams have not acted on it yet.

What changed

According to the write-ups from emailmarkup.org (September 21) and Dyspatch (October 8):

  • The Gmail apps for iOS and Android now recognize the color-scheme meta tag.
  • Only the light only value is honored. Gmail skips its forced dark theme and shows the email as designed in light mode.
  • This does not cover Gmail on desktop webmail.
  • emailmarkup.org reports it applies to emails received in Google accounts (@gmail.com or Google Workspace), not third-party accounts read through the Gmail app. Dyspatch says this account-type limit is still unconfirmed.

To be clear about what this is not: Gmail is not suddenly supporting your custom prefers-color-scheme dark styles. It is giving you an off switch for its own inversion. That is a smaller change, but for brands with strict color rules, it is a big one.

The code

Here is the tag that goes in your head:

<meta name="color-scheme" content="light only">

There is a catch. Other clients, Apple Mail in particular, also read color-scheme. If you already ship a custom dark mode for Apple Mail, you do not want to switch it off by accident. Dyspatch suggests keeping dark mode available to those clients with a CSS declaration alongside the meta tag:

:root {
  color-scheme: light dark;
}
@media (prefers-color-scheme: dark) {
  .bg-body { background-color: #111111 !important; }
  .text-body { color: #f2f2f2 !important; }
}

Dyspatch says you only need the CSS reset if you have custom dark mode styles. I would treat this combination as a starting point to test, not a guaranteed result in every client.

Should every email use light only?

Not automatically. My take:

  • Use it when inversion actively breaks the design: brand colors that must stay exact, illustrated hero images with transparent backgrounds, dark logos on transparent PNGs, or charts and product shots where color carries meaning.
  • Think twice for text-heavy newsletters and transactional emails. Many people turn on dark mode on purpose, often for comfort or eye strain. Forcing a bright white email at night is a real experience cost, and it can be an accessibility one too.
  • Best of both is still a well-built custom dark mode for clients that support it, with light only as a targeted fix for Gmail's app inversion.

How I'm testing it

The reports so far come with caveats. Dyspatch notes that Litmus Gmail app previews were still showing forced dark mode, so a screenshot tool may not reflect what real subscribers see. My QA checklist for this change:

  1. Do real sends to a @gmail.com address and a Google Workspace address, opened in the Gmail app on both iOS and Android with system dark mode on.
  2. Send to a non-Google account (Outlook.com or Yahoo) added to the Gmail app, to see whether the behavior differs.
  3. Check Apple Mail on iOS and macOS in dark mode to make sure your custom dark styles still apply.
  4. Check Outlook on Windows and Outlook.com, which handle dark mode in their own way.
  5. Keep screenshots of each so the client can see exactly what changed.

What this means for agencies and brands

If you are an agency, this is worth a quick audit of your base template. One tag, tested properly, can remove a whole category of "why does our logo look broken in Gmail?" tickets. If you are a brand, ask whoever builds your emails whether they have looked at this yet, and whether light only actually suits your audience.

If you want a second pair of eyes on your templates, this is exactly the kind of dark mode QA I do for agency and brand teams every week.

Sources

Work with me

Need this handled in your templates?

Send me your design file or the HTML that's misbehaving. You'll get a clear scope, timeline and quote within 1 business day.