Bots are silently destroying your Klaviyo deliverability.

Save My Spot β†’
Learn β€Ί Email Templates β€Ί Dark Mode Email
Part 3 of 15 Β· Email Templates

Dark Mode Email Design:
45% of Opens Occur in Dark Mode

Apple Mail, iOS Mail, Outlook macOS, and Samsung Mail all support dark mode. Nearly half of all email opens occur in dark mode clients. Poor dark mode design reduces engagement and raises unsubscribe rates. Master CSS media queries, color palette strategy, Outlook data attributes, and image handling.

2026 Current

Dark mode adoption has reached ~45% of all email opens. Apple Mail, iOS Mail, Outlook macOS, and Samsung Mail are the dominant dark mode clients. Outlook dark mode uses forced color mode with no CSS media query support.

Dark Mode Adoption Data

Analysis of 2026 email opens shows approximately 45% occur in dark mode clients. This is a significant shift from previous years and requires serious design consideration. Ignoring dark mode users risks engagement drop, increased unsubscribe rates, and poor inbox placement signals to ISPs.

Dark Mode Client Market Share (2026):

  • Apple Mail (macOS): 15-18%
  • iOS Mail: 20-22%
  • Samsung Mail (Android): 5-7%
  • Outlook macOS: 3-5%
  • Other dark mode clients: 2-3%
  • Combined: ~45-55% of all opens

Light Mode Dominance (still 50%+):

  • Gmail (no native dark mode): 20-25%
  • Yahoo Mail: 8-10%
  • Outlook.com: 5-7%
  • Outlook Windows (light mode): 8-10%
  • Web clients: 5-7%

The Challenge: Your email must work beautifully in both light and dark modes. A design optimized for light mode only will look broken to nearly half your audience.

Four Dark Mode Rendering Behaviors

Not all dark mode clients work the same way. Understanding these four behaviors is critical for designing emails that look good everywhere.

1. No Dark Mode Support (50-55% of opens)

  • Gmail, Yahoo Mail, Outlook.com, web clients show emails exactly as designed
  • No automatic color inversion or adjustment
  • Your light color palette displays as-is
  • Strategy: Design light mode first; dark mode CSS enhances it

2. Smart Inversion (25-30% of opens)

  • Apple Mail and iOS Mail apply intelligent color adjustments
  • Light text on dark background is handled gracefully
  • Images are NOT inverted (logos stay correct colors)
  • Supports CSS `@media (prefers-color-scheme: dark)` for custom styling
  • Strategy: Provide explicit dark mode CSS; don't rely on auto-inversion alone

3. Forced Color Mode (8-10% of opens)

  • Outlook Windows applies system-wide dark mode overrides
  • Ignores CSS media queries entirely
  • Uses `[data-ogsc]` and `[data-ogsb]` data attributes instead
  • Text colors are forced to white, backgrounds forced to dark
  • Strategy: Use Outlook-specific data attribute selectors for explicit control

4. Full Color Inversion (rare, <1%)

  • Some older or custom email clients invert all colors blindly
  • Light colors become dark, dark colors become light
  • Can break images and logos (becomes incorrect colors)
  • Unpredictable and usually not worth optimizing for

@media (prefers-color-scheme: dark)

Apple Mail, iOS Mail, and Samsung Mail support the standard CSS media query for dark mode. Use `@media (prefers-color-scheme: dark)` to apply dark mode-specific styles. This is the modern, standard approach.

Complete Dark Mode CSS Example:

Important Rules:

  • Default styles are light mode β€” dark mode media query overrides them
  • Only include dark mode rules inside the media query
  • Ensure WCAG AA contrast in both light and dark modes
  • Test in Apple Mail and iOS Mail to verify media query support

Outlook Dark Mode: Data Attributes

Outlook Windows uses forced color mode with no CSS media query support. Instead, use Outlook-specific data attribute selectors to override text and background colors.

Two Key Data Attributes:

  • `[data-ogsc]` β€” Outlook text color (ogsc = Outlook Generated Styles Color)
  • `[data-ogsb]` β€” Outlook background color (ogsb = Outlook Generated Styles Background)

Outlook Data Attribute Example:



This text is dark in light mode, white in Outlook dark mode.

Why !important is Necessary: Outlook's forced color mode attempts to override inline styles. Using `!important` ensures your dark mode colors win.

Combined Apple + Outlook Solution:

Color Palette Strategy

Your color palette must work in both light and dark modes. Use these strategies to ensure readability and brand consistency.

Contrast Levels (WCAG AA Minimum 4.5:1):

  • Body text: Minimum 4.5:1 contrast in light mode AND dark mode
  • Headings: Minimum 3:1 contrast (acceptable for larger text)
  • Decorative elements: No minimum requirement

Light Mode Color Examples:

  • Background: #FFFFFF (white)
  • Primary text: #222222 (dark gray) β€” 19:1 contrast βœ“
  • Secondary text: #666666 (medium gray) β€” 7:1 contrast βœ“
  • Accent button: #0066CC (blue) with white text β€” 8.6:1 contrast βœ“

Dark Mode Color Examples:

  • Background: #1A1A1A (dark gray)
  • Primary text: #F0F0F0 (light gray) β€” 17:1 contrast βœ“
  • Secondary text: #AAAAAA (medium gray) β€” 5.5:1 contrast βœ“
  • Accent button: #4499FF (light blue) with dark text β€” 6.2:1 contrast βœ“

Safe Color Palette Approach:

Light mode:
  Background: white (#FFFFFF)
  Text: very dark gray (#1A1A1A or darker)
  Accent: brand blue/purple (saturated, high contrast on white)

Dark mode:
  Background: very dark (#1A1A1A or darker)
  Text: off-white (#E8E8E8 to #F5F5F5)
  Accent: lighter version of brand color (e.g., add 20-30% lightness)
                

Testing Your Palette: Use WebAIM Contrast Checker or Accessible Colors to verify 4.5:1 contrast in both modes before finalizing.

Color-Scheme Meta Tag

Add the `color-scheme` meta tag to your email HTML to signal to email clients that your email supports both light and dark modes. This helps clients render your email more intelligently.

Implementation:

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

What This Does:

  • Tells email clients your email is optimized for both light and dark
  • Prevents clients from applying aggressive auto-inversion
  • Supported by Apple Mail, iOS Mail, Samsung Mail, and some others
  • Clients without support simply ignore it (safe to always include)

Full Email Head Example:


  
  
  
  Your Email Subject

Logo and Image Handling

Images are NOT inverted in dark mode (unlike text and backgrounds). This means transparent-background logos may disappear in dark mode, and light logos may become hard to see.

Problem: Transparent Logo in Dark Mode

  • Light logo with transparent background β†’ invisible on dark email background
  • Dark logo with transparent background β†’ fine in light mode, barely visible in dark mode

Solution 1: Dual Logo Assets (Recommended)



InboxEagle

Solution 2: White Border/Background

/* Add border or background to dark logo for visibility in both modes */
img.logo {
  width: 200px;
  padding: 8px;
  background-color: white;
  border: 1px solid #E0E0E0;
}

@media (prefers-color-scheme: dark) {
  img.logo {
    background-color: transparent;
    border: 1px solid #555555;
  }
}

Image Optimization Tips:

  • Use logos with solid background colors, not transparent
  • Test images in both Apple Mail light and dark modes
  • Always include descriptive alt text (accessibility + fallback display)
  • Use 2x pixel density for Retina display clarity (e.g., 400px image for 200px display)

Testing: Dark Mode Across Clients

Dark mode rendering varies significantly across clients. Thorough testing is essential before sending campaigns.

Priority Testing Clients (cover 45% of dark mode opens):

  • Apple Mail (macOS) β€” Preferences > Viewing β†’ Dark Mode
  • iOS Mail β€” Settings > Mail β†’ Dark Mode toggle
  • Outlook macOS β€” Preferences > Reading β†’ Dark Mode
  • Outlook Windows β€” File > Options > Mail > Compose Messages > Dark Mode
  • Samsung Mail β€” Settings > Display β†’ Dark Mode

Manual Testing Workflow:

  1. Send test email to yourself
  2. Open in Apple Mail light mode β€” verify colors, contrast, images
  3. Switch Apple Mail to dark mode β€” verify CSS media queries applied correctly
  4. Open in iOS Mail light mode β€” check mobile layout and contrast
  5. Switch iOS Mail to dark mode β€” verify responsive images and colors
  6. Test in Outlook Windows β€” check [data-ogsc] overrides work
  7. Open in Gmail β€” verify light mode design (no dark mode changes should affect it)

Automated Testing Tools:

  • Litmus β€” Preview across 90+ clients including dark mode
  • Stripo β€” Dark mode preview for Apple Mail and iOS
  • InboxEagle β€” Real inbox placement testing with dark mode detection by client

What to Check in Each Test:

  • Text contrast: Readable in both light and dark?
  • Images: Visible and correct colors in both modes?
  • Logos: Clear and recognizable?
  • Buttons: High contrast and clickable in both modes?
  • Links: Distinct from body text in both modes?
  • Borders/dividers: Visible in both modes?

Next in the Email Templates Series

Learn the 2026 HTML email template boilerplate and modern best practices for email structure.

HTML Email Template
Explore with AI

Open this content in your AI assistant for deeper analysis, or copy it as Markdown to paste anywhere.