# Dark Mode Email Design: Logos, Colours and Code That Work

> How mail apps handle dark mode email, the meta tags and CSS you can use, and design choices for logos and colours that still work when code can't help.

Canonical: https://www.cresca.xyz/blog/dark-mode-email-design
Author: Lalit Kumar Jangid
Published: 2026-09-15
Last updated: 2026-10-26

You design a clean email with a black logo on a white background, send a test, and it looks perfect. Then someone opens it on a phone set to dark mode and your logo has vanished into a charcoal background. Dark mode email is not one feature you can switch on; it is a set of different behaviours across mail apps, some of which you can control and some you cannot. This post explains those behaviours, gives you code for the cases you can influence, and shows how to design so the cases you cannot control still look acceptable.

## What are the three ways mail apps handle dark mode?

Mail apps handle dark mode in one of three ways. Some make no colour change and show your email exactly as designed. Some apply a partial invert, darkening light backgrounds and lightening dark text. Others apply a full invert, flipping both light and dark areas, so even a deliberately dark design can change.

Litmus's [guide to dark mode for email marketers](https://www.litmus.com/blog/the-ultimate-guide-to-dark-mode-for-email-marketers) groups client behaviour into three treatments. It is the most useful mental model to start from:

- **No colour change.** The app shows your email exactly as designed, even when its own interface is dark.
- **Partial invert.** The app darkens light backgrounds and lightens dark text, but leaves areas that are already dark mostly alone.
- **Full invert.** The app inverts both light and dark areas, so even a deliberately dark design can get flipped.

Which app does what changes over time as clients update, so check that guide or your own tests for the current list rather than relying on a table you saved last year. The design implication for every dark mode email stays the same: you are writing for at least three different renderings of the same message.

## Step 1: Tell clients your email supports both schemes

Two meta tags and a matching CSS property in the `<head>` signal that you have thought about dark mode:

```
<meta name="color-scheme" content="light dark">
<meta name="supported-color-schemes" content="light dark">
<style>
  :root { color-scheme: light dark; supported-color-schemes: light dark; }
</style>
```

MDN's [color-scheme reference](https://developer.mozilla.org/en-US/docs/Web/CSS/color-scheme) explains the property: it declares which colour schemes an element can be rendered in. On the web it changes things like default backgrounds and form controls; in email, its main role is to tell supporting clients that your styles are dark-mode aware. Support for the meta tag varies a lot by client; Can I Email tracks it on its [color-scheme meta page](https://www.caniemail.com/features/html-meta-color-scheme/), which notes, for instance, that the Gmail apps for iOS and Android support only the value `light only`.

## Step 2: Provide your own dark styles where you can

The `prefers-color-scheme` media query, documented on [MDN](https://developer.mozilla.org/en-US/docs/Web/CSS/@media/prefers-color-scheme), lets you supply dark colours instead of letting the client guess:

```
<style>
  @media (prefers-color-scheme: dark) {
    .email-bg   { background-color: #121417 !important; }
    .card       { background-color: #1c1f24 !important; }
    .text       { color: #e6e6e6 !important; }
    .muted      { color: #a8adb4 !important; }
    .btn        { background-color: #4c8dff !important; }
    .logo-light { display: none !important; }
    .logo-dark  { display: block !important; }
  }
</style>
```

Be realistic about reach. Can I Email's [prefers-color-scheme support table](https://www.caniemail.com/features/css-at-media-prefers-color-scheme/) lists clients that honour the query and others that strip or transform it, including several webmail services. The Outlook apps are a special case: the same page notes that Outlook.com and the Outlook mobile apps add custom attributes such as `data-ogsc` and `data-ogsb` in dark mode, which you can target directly.

```
[data-ogsc] .text { color: #e6e6e6 !important; }
[data-ogsb] .card { background-color: #1c1f24 !important; }
```

Litmus's guide recommends duplicating your dark rules with these prefixes. It is extra code, but it is cheap and isolated.

### A note on where styles live

Your dark-mode rules only work if the client keeps your `<style>` block. Can I Email's [<style> element page](https://www.caniemail.com/features/html-style/) notes, among other things, that Gmail does not support style blocks inside the `<body>`. Keep them in the head, and keep inline styles as your light-mode baseline.

## Step 3: Design for the apps you cannot control

For clients that ignore your dark styles and invert colours on their own, code will not save you. Design choices will.

### Logos and icons

- Use transparent PNGs rather than images with a baked-in white box, which turns into a glaring rectangle on a dark background.
- For dark logos, add a thin light outline or soft glow around the mark. It is nearly invisible on white and keeps the logo legible on black.
- If you can target dark mode, swap in a light version of the logo with the `.logo-light` / `.logo-dark` pattern above. Put the dark-mode version in the HTML hidden by default with an inline `display:none`, so clients that strip styles still show the light-mode logo.

### Colours

- Avoid relying on pure #ffffff and #000000 for large areas. Slightly off-white and off-black values are less likely to produce harsh contrast after inversion.
- Pick brand and button colours with enough contrast against both light and dark backgrounds. Mid-tone blues and greens usually survive; pale pastels and near-black navies often do not.
- Check text against the [WCAG 4.5:1 contrast minimum](https://www.w3.org/WAI/WCAG22/Understanding/contrast-minimum.html) in both your light palette and your dark palette.

### Why does text inside images break in dark mode?

Images are not inverted the way HTML text is. A banner with dark text on a transparent background can become unreadable when the background behind it darkens. Keep headlines and calls to action as live text, and give text-bearing images their own solid background with some padding around the edges.

### Borders and dividers

A light grey hairline that separates sections on white can disappear on dark. Use slightly stronger dividers, or spacing alone, to separate content.

## A starter dark mode email palette

Map each light-mode colour to a dark equivalent once, and reuse it. An example mapping (adapt to your brand):

| Role | Light | Dark |
| --- | --- | --- |
| Page background | #f4f5f7 | #121417 |
| Card background | #ffffff | #1c1f24 |
| Body text | #1f2328 | #e6e6e6 |
| Secondary text | #57606a | #a8adb4 |
| Primary button | #1f6feb | #4c8dff |

Run each text-and-background pair through a contrast checker before you commit.

## How do you test dark mode email without a device lab?

Switch your own phone and computer to dark mode and send a test to every mail app you have installed, then ask a colleague on a different platform for a screenshot. For each rendering, check that the logo is visible, all text is readable, buttons are distinct and no white boxes surround images.

1. Switch your own phone to dark mode and send a test to every mail app you have installed. Most people have at least two.
2. Do the same on a computer with the operating system set to dark.
3. Ask a colleague on a different platform to forward a screenshot.
4. For each rendering, check: logo visible, all text readable, buttons distinct, no white boxes around images.
5. If a dedicated rendering-preview service fits your budget, use it before big sends, but your own devices catch most problems.

## Building this into your workflow

Dark mode email problems are easiest to fix at the template level, once, rather than campaign by campaign. Settle your palette, logo files and dark rules in a base template and reuse it. If you build emails in Cresca's visual editor, keep a tested template as your starting point and adjust copy and images per campaign; our post on [Cresca templates](https://www.cresca.xyz/blog/cresca-templates) covers how to work from one.

You will not get pixel-identical results across every app, and that is fine. The goal is narrower: every reader, in every mode, can see your logo, read your words and find your button. Many of those readers are on a phone, so pair this with our [mobile email optimization](https://www.cresca.xyz/blog/mobile-email-optimization) checklist.
