Skip to main content

Our email CSS engine is open source. Give it a star on GitHub 

Emailens

HTML element · data last changed 10 Nov 2026

<picture> in email clients

Works in 4 of 21. Not supported in Gmail, Gmail Android, Gmail iOS and 13 more. Partial in Apple Mail.

Your reader in Outlook Classic sees the email without <picture>, even if it looks right where you tested it.

caniemail (MIT) via @emailens/engine 0.18.22

What to do instead in Outlook Classic

Always include an <img src="..." alt="..." /> tag as the last child inside <picture> with explicit width, height, and display: block. For Outlook Classic, ensure the default <img> points to the universal light-mode graphic or use conditional MSO comments.

There is no drop-in fix for <picture> in Outlook Classic. Design so the email still reads without it.

The checker needs a computer screen.

A free account opens all 21 clients and keeps your checks for 7 days. Create a free account →

Every account includes one free real-device check in classic Outlook, Outlook for Mac and Apple Mail, after you verify your email and run one preview, while this month's free capacity lasts. How real-device checks work →

<picture> is not among the 24 features we have screenshotted on real installs. The ones we have →

All 21 clients, problems first

ClientSupport
Gmail Not supported See caveat 1
Gmail Android Not supported See caveat 1
Gmail iOS Not supported See caveat 1
Outlook 365 Not supported
Outlook (New) Not supported
Outlook Classic Not supported
Outlook iOS Not supported
Outlook Android Not supported
Outlook for Mac Not supported
Yahoo Mail Not supported
Yahoo Mail Android Not supported
Yahoo Mail iOS Not supported
HEY Mail Not supported
Proton Mail Not supported
AOL Mail Not supported
Fastmail Not supported
Apple Mail Partial See caveat 2
Works in 4: Apple Mail iOS, Samsung Mail, Thunderbird and 1 more. Show all
ClientSupport
Apple Mail iOS Works
Samsung Mail Works
Thunderbird Works
Superhuman Works

Caveats (2)

  1. 1. Gmail, Gmail Android, Gmail iOS: <picture> and <source> tags are replaced by <u></u> tags.
  2. 2. Apple Mail: <picture> tag is stripped in some cases (like having too few content or no background-color).

Caveats as recorded by caniemail (MIT), one entry per wording.

How <picture> behaves

The HTML5 <picture> element enables art direction and responsive image switching via media queries and format detection. In email development, it is the primary modern mechanism for delivering dark-mode graphic swaps and mobile-cropped photos, but lack of support in Outlook Classic and older webmail requires strict image fallback nesting.

  • Outlook Classic does not support <picture> and will render only the nested <img> fallback or drop the element entirely if malformed.
  • Gmail web and mobile actively rewrite <picture> and <source> tags into dummy <u></u> tags during sanitization, leaving only the nested <img> to render.
  • Apple Mail and Apple Mail iOS fully support <picture>, honoring <source media="(prefers-color-scheme: dark)"> for seamless dark-mode graphic swaps (though Apple Mail may strip empty containers).

Questions

Can I use <picture> to swap logos in dark mode for email?

Yes, for Apple Mail and Thunderbird. However, because Gmail ignores <source> media queries inside <picture> (replacing them with <u> tags), you must ensure the default <img> fallback looks acceptable on both light and dark backgrounds.

Does Outlook Classic render <picture>?

No. Outlook Classic's Word engine ignores <picture> and <source> tags and renders only the fallback <img> element.

Your next question

Every feature in Outlook Classic · All email CSS features · What real installs show

Get new email CSS fixes by email.

caniemail (MIT) via @emailens/engine 0.18.22 · tested upstream 15 Apr 2024 · data last changed 10 Nov 2026 · Outlook (New) cells are the engine's mapping