Back to all posts
Dark Mode Email Design: How to Support It
Email Design

Dark Mode Email Design: How to Support It

JP
Jordan ParkEmail Designer
Published
9 min read

Why Dark Mode in Email Is Non-Trivial

Dark mode in web browsers is relatively straightforward: you respond to the prefers-color-scheme: dark media query and provide alternative color variables. Email is significantly more complex because different email clients implement dark mode in fundamentally different ways — some give you control, some don't, and some will forcibly modify your email's colors whether you want them to or not.

Without explicit dark mode handling, your carefully designed email with a white background and dark text might arrive looking like photographic negatives: dark background, bright white text, vivid neon images. For subscribers who live in dark mode (an increasingly large segment), this is an unpleasant experience. For branded emails where color consistency matters, it can be genuinely damaging to perception.

Understanding how each major client handles dark mode — and how to respond to each — is the key to supporting dark mode well.

How Email Clients Handle Dark Mode

Apple Mail and iOS Mail

Apple Mail is the most developer-friendly when it comes to dark mode. It supports the @media (prefers-color-scheme: dark) media query and respects the color-scheme CSS property and meta tag. If you provide explicit dark mode styles, Apple Mail will use them.

If you don't provide dark mode styles, Apple Mail will perform "partial color inversion" — it inverts light backgrounds and light text to their dark equivalents, but attempts to leave images and already-dark elements unchanged. The results are inconsistent but generally acceptable.

Gmail

Gmail's dark mode behavior differs by platform. On iOS and Android, Gmail respects the system dark mode preference and performs its own automatic color transformation on emails that don't have explicit dark mode support. The transformation algorithm attempts to preserve the email's visual hierarchy, but it can produce unexpected color combinations.

Gmail on the web (desktop) doesn't apply dark mode transformations to email content — emails render as-coded regardless of the system setting. This means your light-mode design is always preserved in Gmail web, but mobile Gmail subscribers may see an automatically transformed version.

Outlook

Outlook on Windows does not support dark mode transformations for email content. Emails render in light mode regardless of the system dark mode setting. Outlook for Mac and Outlook on iOS do apply dark mode transformations, similar to Apple Mail.

Samsung Mail

Samsung Mail aggressively applies dark mode transformations. It inverts backgrounds and text colors but attempts to leave images untouched. Like Gmail, it can produce surprising results when it encounters unusual color combinations.

The Three Dark Mode Implementation Strategies

Strategy 1: Ignore Dark Mode

Some organizations choose not to implement explicit dark mode support, accepting that their emails will display in the automatic transformation of each client. This is the simplest approach and reasonable for high-volume transactional emails where design polish isn't the priority.

The risk: clients that perform aggressive automatic inversion (Samsung Mail, mobile Gmail) may produce results you'd consider embarrassing for a marketing email. Test the automatic behavior before committing to this strategy.

Strategy 2: Prevent Dark Mode Transformations

You can tell email clients to render your email in light mode only, preventing automatic dark mode transformations:

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

This preserves your light mode design for all subscribers, including those in dark mode. It's a legitimate choice for emails where color accuracy is critical and you don't have time to build a full dark mode version. The tradeoff: dark mode users may find a bright white email jarring in a dark environment.

Strategy 3: Build an Explicit Dark Mode Version

The best outcome: a genuinely designed dark mode version of your email that looks good in dark mode without sacrificing light mode quality. This requires more development time but delivers the best subscriber experience.

The implementation uses the @media (prefers-color-scheme: dark) media query alongside the color-scheme meta tag:

<meta name="color-scheme" content="light dark">
<style>
  :root { color-scheme: light dark; }
  
  @media (prefers-color-scheme: dark) {
    .email-body { background-color: #1a1a2e !important; }
    .email-container { background-color: #16213e !important; }
    .email-text { color: #e0e0e0 !important; }
    .email-heading { color: #ffffff !important; }
    .email-link { color: #a78bfa !important; }
    .light-only { display: none !important; }
    .dark-only { display: block !important; }
  }
</style>

Dark Mode Design Principles

Avoid Pure Black and Pure White

In dark mode, a pure black (#000000) background creates harsh contrast that causes eye strain. Use very dark grays (#0f0f0f, #1a1a2e, #111827) for backgrounds. Similarly, pure white (#ffffff) text on dark background is too harsh — use off-whites (#e5e5e5, #f3f4f6) instead.

Reduce Saturation for Background Colors

Vivid, saturated colors that look great on white backgrounds can appear garish against dark ones. When translating brand colors to dark mode, slightly desaturate and increase brightness. Your brand's primary blue might be #2563eb in light mode but #60a5fa (lighter, slightly less saturated) in dark mode.

Use Logo Variants

If your logo is a dark wordmark on a transparent background, it will be invisible in dark mode. Use the .light-only / .dark-only pattern (above) to swap logo variants. Maintain a light version of your logo specifically for dark mode use.

Maintain Sufficient Contrast

The WCAG minimum contrast ratio is 4.5:1 for normal text. In dark mode, light text on dark backgrounds needs to be light enough to maintain this ratio. Use a contrast checker to verify your dark mode color combinations meet accessibility requirements.

Test Images on Dark Backgrounds

Photos with white backgrounds become particularly problematic in dark mode — the white bleeds into the dark email background. Use images with transparent backgrounds where possible, or consider adding a subtle background container behind images that works in both modes.

Testing Dark Mode

Dark mode testing requires seeing your email in both modes across multiple clients. Postdrop.io includes dark mode preview toggles for each client render, so you can see exactly what your email looks like in Apple Mail dark mode, Gmail dark mode, and others — without setting up a device for each. This dramatically speeds up the iteration cycle when fine-tuning dark mode colors.

Pay particular attention to Apple Mail (which fully respects your dark mode CSS) and Gmail on iOS and Android (which applies its own transformation unless you use color-scheme: light to prevent it). These are the highest-impact clients for dark mode subscribers.

Stop guessing how your emails will render

Join thousands of developers using Postdrop.io to build, test, and share beautiful HTML emails in record time.

Try Postdrop.io for Free

More on Email Design