---
title: "Dark mode email design: what each email client does and how to fix it"
url: https://stensul.com/stream/5-must-dos-when-designing-emails-for-dark-mode/
type: article
published: 2026-11-20
author: "Team Stensul"
publisher: Stensul
summary: "Dark mode email design means building an email that stays readable and on brand when the client swaps light backgrounds for dark ones. Apple Mail follows your dark mode styles, while the Gmail apps and Outlook for Windows recolor the email themselves, so choose colors, logos and buttons that hold up in every version."
---

# Dark mode email design: what each email client does and how to fix it

> Dark mode email design means building an email that stays readable and on brand when the client swaps light backgrounds for dark ones. Apple Mail follows your dark mode styles, while the Gmail apps and Outlook for Windows recolor the email themselves, so choose colors, logos and buttons that hold up in every version.

## Answers

- How do Gmail, Outlook and Apple Mail change an email in dark mode, and how do you design for it?

## Key facts

- In dark mode, email clients do one of three things to an email. They leave it unchanged, partly invert it (light backgrounds turn dark, dark areas stay), or fully invert every color. (https://www.litmus.com/blog/the-ultimate-guide-to-dark-mode-for-email-marketers, 2026-11-13)
- The Gmail apps and Outlook for Windows ignore dark mode CSS (the prefers-color-scheme media query) and recolor the email themselves. Apple Mail reads it. (https://www.caniemail.com/features/css-at-media-prefers-color-scheme, 2026-11-13)
- Litmus measured an average of 35% of tracked email opens in dark mode in 2022. (https://www.litmus.com/blog/the-ultimate-guide-to-dark-mode-for-email-marketers, 2026-11-13)
- Email text needs a contrast ratio of at least 4.5:1, or 3:1 for large text, to meet WCAG AA, and the ratio should be checked after dark mode inversion too. (https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html, 2026-11-13)

Topics: Brand governance

**Key points**

- Email clients do one of three things in dark mode: leave the email alone, partly invert it, or fully invert it.
- Only some clients read dark mode CSS. The Gmail apps and Outlook for Windows ignore it.
- Logos and icons are what break most often. Text and buttons usually stay readable.
- Fix the assets first. Write dark mode CSS only if the clients that honor it are a large share of your list.

**Check your brand colors in dark mode.** The free [Dark Mode Color Checker](/dark-mode-color-checker/) needs no form.

## What does dark mode do to an email?

It depends on the client. There are three behaviors. **No change:** the client's own interface goes dark but your email keeps its light colors. **Partial inversion:** light backgrounds turn dark and dark text turns light, while areas that were already dark are left alone. **Full inversion:** every color flips, including dark backgrounds and buttons you designed to be dark.

In Stensul's render tests, Outlook's partial inversion also darkens bright brand colors, so a bright button can come out duller than the one you designed.

## How does each email client handle dark mode?

| Email client | What it does to your email | Reads your dark mode CSS? |
| :--- | :--- | :--- |
| Apple Mail (Mac, iPhone, iPad) | No change unless you opt in | Yes |
| Gmail on the web | No change | No |
| Gmail app on Android | Partial inversion | No |
| Gmail app on iPhone | Full inversion | No |
| Outlook for Windows (classic desktop) | Full inversion | No |
| Outlook.com and new Outlook | Partial inversion | Limited, through Outlook-specific selectors |
| Outlook for Mac | Partial inversion | Partly |
| Outlook app on iPhone and Android | Partial inversion | Limited, through Outlook-specific selectors |
| Yahoo Mail and AOL | No change | No |

Table checked November 2026 against [Litmus's client chart](https://www.litmus.com/blog/the-ultimate-guide-to-dark-mode-for-email-marketers) and Stensul render tests. Clients change their behavior without notice, so treat any table like this as a starting point and confirm with a render test.

## How many people read email in dark mode?

Enough that every send is affected. [Litmus](https://www.litmus.com/blog/the-ultimate-guide-to-dark-mode-for-email-marketers) measured an average of 35% of tracked opens in dark mode in 2022, and its [more recent market share reporting](https://www.courier.com/blog/dark-mode-email-design) still puts dark mode above a quarter of opens. The share on your own list depends on how many subscribers use Apple Mail and the Gmail and Outlook mobile apps.

## Why do logos disappear in dark mode?

A dark logo saved as a transparent PNG sits directly on the background. When the client turns that background dark, the logo is dark on dark and vanishes. Clients recolor backgrounds and text, but they do not reliably recolor the pixels inside an image.

The fix is one logo file with a thin light outline or glow around the dark shapes. It is invisible on a white background and keeps the logo legible on a dark one, so the same file works in light mode and in every dark mode. Do the same for footer and social icons, and keep their backgrounds transparent so they do not show as white boxes.

## Should you write dark mode CSS for your emails?

Often, no. Dark mode CSS only holds your colors in the [clients that read it](https://www.caniemail.com/features/css-at-media-prefers-color-scheme), mainly Apple Mail and some versions of Outlook. The Gmail apps and Outlook for Windows recolor the email anyway, so part of your audience sees shifted colors whatever you write. The extra CSS also adds weight to every email, which raises the risk of [Gmail clipping](/stream/how-to-stop-gmail-clipping-emails/) long messages, and it moves color decisions out of the design system and into code that a developer has to maintain.

Stensul's recommendation for most enterprise teams: make sure your color pairs pass contrast in all three behaviors, fix logos and icons, and stop there. Add dark mode CSS when Apple Mail is a large share of your opens and brand color accuracy there is worth the upkeep.

If you do write it, opt in with both meta tags and put your overrides in the media query:

```html
<meta name="color-scheme" content="light dark">
<meta name="supported-color-schemes" content="light dark">
```

```css
@media (prefers-color-scheme: dark) {
  .body-bg { background-color: #16181d !important; }
}
```

## Five fixes that work in every email client

1. **Test every color pair in all three behaviors.** Check text on background for light mode, partial inversion and full inversion. Small text needs a contrast ratio of at least 4.5:1 to meet [WCAG AA](https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html), and large text needs 3:1.
2. **Outline dark logos and icons.** One file with a thin light outline, on a transparent background.
3. **Keep text as live text.** Words baked into an image do not invert with the rest of the email and can show up as a bright rectangle.
4. **Avoid pure white text on pure black.** Slightly off-white on near-black is easier to read and survives inversion better.
5. **Test before every template change.** Check Apple Mail, the Gmail app on iPhone and Android, and Outlook for Windows at minimum, because between them they cover all three behaviors.

## How do you test an email in dark mode?

Send the email to real devices or use a render testing tool, and look at it in at least one client from each behavior group. Check logos, icons, buttons and any text that sits on a colored background. Then repeat the check whenever a color, logo or module changes, because one new color can fail in full inversion while everything else passes.

**See your own template in dark mode before anyone hits send.** [Get a demo](/request-a-demo-v2/).

## How Stensul handles dark mode

In Stensul, dark mode is solved once in the module library instead of in every email. Your brand team sets the approved colors, logo files and icons in the modules, and every email a marketer builds inherits them, so nobody can ship a logo that disappears. Email Testing sits inside the [Email Builder](/email-builder/): you toggle between light and dark mode and preview across email clients without leaving the email you are working on.

**Build emails that hold up in every inbox.** [Get a demo](/request-a-demo-v2/), or download the guide [The five most perplexing dark mode email design problems](/resource/the-5-most-perplexing-dark-mode-email-design-problems/).

## Dark mode email FAQ

### Does Gmail support dark mode CSS?

No. Gmail on the web leaves emails unchanged, and the Gmail apps apply their own inversion and ignore the dark mode media query. You cannot style Gmail's dark mode, so design colors that survive it.

### Can I stop an email client from applying dark mode?

Not reliably. There is no setting that every client honors. Outlook for Windows and the Gmail apps recolor the email even when you declare a light-only color scheme.

### Why does my email look different in Gmail on iPhone and on Android?

The two apps use different methods. Gmail on Android partly inverts the email. Gmail on iPhone fully inverts it, which also flips areas you designed to be dark.

### What contrast ratio should email text have in dark mode?

The same as in light mode: at least 4.5:1 for body text and 3:1 for large text, which is WCAG AA. Check the ratio after inversion, not only in your original design.

### Does dark mode affect deliverability?

Not directly. Mailbox providers do not filter on it. An email that is unreadable in dark mode gets fewer clicks and more deletions, and weak engagement is what hurts inbox placement over time.

### Does dark mode code make emails heavier?

Yes. Dark mode styles are extra CSS in every email. On long emails that can push the HTML toward the size where Gmail clips the message. See the [guide to Gmail clipping](/stream/how-to-stop-gmail-clipping-emails/).
