Skip to main content
Emailens
HTML & Email Structure

html5-semantics

CSS property · 7 supported, 8 partial, 5 unsupported across 21 clients

As of Oct 14, 2026, html5-semantics fails or degrades in 14 of 21 email clients, treat it as progressive enhancement, never structure.

  • 2/7 webmail, 3/6 desktop, 2/8 mobile clients support html5-semantics fully.
  • Unsupported in Outlook Classic, Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS and 1 more.
  • Partial in Gmail, Gmail Android, Gmail iOS, Outlook 365 and 4 more, behavior differs from browsers, test before relying on it.
  • Outlook Classic (Word engine, supported to at least 2029) does not fully support html5-semantics, and its replacement changes little here; see the deprecation diff.
  • Across all clients, only 6 of 298 tracked HTML/CSS features render identically everywhere.

Source: caniemail.com (MIT), via the Emailens engine. Last tested upstream Jul 29, 2019, synced by Emailens Oct 14, 2026.

Client Support

ClientCategoryEngineSupport
GmailwebmailGmail WebPartialSee caveat 1
Gmail AndroidmobileGmail MobilePartialSee caveat 1
Gmail iOSmobileGmail MobilePartialSee caveat 1
Outlook 365webmailOutlook WebPartialSee caveat 2
Outlook (New)desktopOutlook WebPartialSee caveat 2
Outlook ClassicdesktopMicrosoft WordUnsupported
Outlook iOSmobileOutlook MobilePartialSee caveat 2
Outlook AndroidmobileOutlook MobilePartialSee caveat 2
Outlook for MacdesktopWebKitSupported
Apple MaildesktopWebKitSupported
Apple Mail iOSmobileWebKitSupported
Yahoo MailwebmailYahooUnsupportedSee caveat 3
Yahoo Mail AndroidmobileYahooUnsupportedSee caveat 3
Yahoo Mail iOSmobileYahooUnsupportedSee caveat 3
Samsung MailmobileSamsungSupported
ThunderbirddesktopGeckoSupported
HEY MailwebmailWebKitPartialSee caveat 4
Proton MailwebmailProtonSupported
AOL MailwebmailAOLUnsupportedSee caveat 3
FastmailwebmailFastmailSupported
SuperhumandesktopBlinkUnknown

Documented caveats (4)

  1. 1.Gmail, Gmail Android, Gmail iOS: Partial. <details>, <main>, <nav> and <summary> are not supported. Opening and closing tags are replaced by <u></u>.
  2. 2.Outlook 365, Outlook (New), Outlook iOS, Outlook Android: Partial. Only <time> is supported. Unsupported opening and closing tags are stripped.
  3. 3.Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS, AOL Mail: Unsupported opening and closing tags are stripped.
  4. 4.HEY Mail: Partial. <article>, <aside>, <header>, <main> <nav>, <section>, <summary> are not supported.

Caveats recorded by caniemail.com (MIT) and carried verbatim, one entry per wording rather than per client.

Client-by-client behaviour for html5-semantics

Fully supports html5-semantics (7): Outlook for Mac, Apple Mail, Apple Mail iOS, Samsung Mail, Thunderbird, Proton Mail, Fastmail.

Partial support (8): Gmail, Gmail Android, Gmail iOS, Outlook 365, Outlook (New), Outlook iOS, Outlook Android, HEY Mail. Expect rendering quirks unique to each engine. Partial support typically means a subset of values, an ignored shorthand, or sanitizer-specific rewrites.

No support (5): Outlook Classic, Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS, AOL Mail. Plan fallbacks for these clients before relying on html5-semantics in production sends.

Behaviour unverified in: Superhuman.

Fixes & Workarounds

Outlook Classic

Unsupported

"html5-semantics" is not supported in this email client.

Yahoo Mail

Unsupported

"html5-semantics" is not supported in this email client.

Yahoo Mail Android

Unsupported

"html5-semantics" is not supported in this email client.

Yahoo Mail iOS

Unsupported

"html5-semantics" is not supported in this email client.

AOL Mail

Unsupported

"html5-semantics" is not supported in this email client.

Gmail

Partial

"html5-semantics" is not supported in this email client.

Gmail Android

Partial

"html5-semantics" is not supported in this email client.

Gmail iOS

Partial

"html5-semantics" is not supported in this email client.

Outlook 365

Partial

"html5-semantics" is not supported in this email client.

Outlook (New)

Partial

"html5-semantics" is not supported in this email client.

Outlook iOS

Partial

"html5-semantics" is not supported in this email client.

Outlook Android

Partial

"html5-semantics" is not supported in this email client.

HEY Mail

Partial

"html5-semantics" is not supported in this email client.

Related Features

Check your own HTML for html5-semantics

Paste your own, or run the sample below. Analyzed in this page, with no signup and nothing stored.

Zero-Friction Engine Preview

Test your html5-semantics layout across 21 email clients

Preview rendering, catch CSS issues, and see how html5-semantics displays across Outlook, Gmail, and Apple Mail. Free, no account needed.

Instant live preview · No signup required · 21 email engines

Last tested upstream: · Last synced by Emailens:

caniemail.com (MIT) records Jul 29, 2019 as the last time html5-semantics was tested in a real client, 7 years before this sync. Syncing copies that result forward, it does not re-test it. Carried in @emailens/engine data v0.14.5.