The three ways inboxes darken an email
- Your dark styles (Apple Mail, iOS Mail): if the email has
<meta name="color-scheme" content="light dark">and dark colours in@media (prefers-color-scheme: dark), these apps use them. Without them, Apple Mail mostly leaves the email light. - Partial invert (Gmail on Android, Outlook.com): light backgrounds are darkened and dark text is lightened, but dark parts and images are left alone.
- Full invert (Gmail on iPhone, classic Outlook on Windows): every colour is flipped, including ones that were already dark; images stay as they are.
What breaks in dark mode
- Logos that vanish: a transparent PNG with dark artwork sits on a dark background. Fix it with a light outline or glow, a solid light panel behind it, or a light version swapped in with a dark-mode style.
- Text on background images: the inbox changes the text colour but not the image, so white text on a light photo can turn dark, or the reverse. Put the text on a solid colour panel, or make it part of the image with the words in the alt text.
- Dark text with no background colour: some inboxes darken the page but leave the text dark. Set a background colour on the body and the main table.
- Dark styles that only reach some inboxes: Outlook.com and the Outlook apps don’t read
prefers-color-scheme; repeat key styles with their[data-ogsc]and[data-ogsb]selectors.
Dark mode and accessibility
The same checks catch contrast problems that hurt readers in light mode too: buttons whose text is too close to their colour, images without alt text and headings out of order. Each finding says what was found and how to fix it.
Frequently asked questions
How do I test an email in dark mode?
Paste the HTML here to see it the three ways inboxes darken email, then send a test to Apple Mail, the Gmail app and Outlook on your own phone for the final check, since each app’s rules change.
Why does my logo disappear in dark mode?
It is usually a PNG with a transparent background and dark artwork. On a dark background there is nothing to separate it. Add a light outline or glow, put it on a light panel, or swap in a light version.
How do I make an email support dark mode?
Add the color-scheme meta tags to the head, set dark colours inside @media (prefers-color-scheme: dark), and repeat the key styles with [data-ogsc] and [data-ogsb] for Outlook.
Can I stop Gmail from inverting my email?
No. Gmail’s apps decide for themselves, so design for it: solid background colours, logos that work on dark, and no text on background images.
Is my email uploaded?
No. Everything runs in your browser and nothing is sent anywhere.