Skip to main content
HTML & Email Structure

html5-semantics

CSS property · 7 supported, 7 partial, 6 unsupported across 21 clients

As of Sep 2, 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 (New), Outlook Classic, Yahoo Mail, Yahoo Mail Android and 2 more.
  • Partial in Gmail, Gmail Android, Gmail iOS, Outlook 365 and 3 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 Sep 2, 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 WebUnsupported
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 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 (7): Gmail, Gmail Android, Gmail iOS, Outlook 365, 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 (6): Outlook (New), 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 (New)

Unsupported

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

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 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.

Test your email in Gmail, Outlook and Apple Mail

Preview rendering, catch CSS issues, and see what Outlook does to your VML. Free, no account. All 21 clients with one.

Try Emailens Free

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.12.2.