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
| Client | Category | Engine | Support |
|---|---|---|---|
| Gmail | webmail | Gmail Web | PartialSee caveat 1 |
| Gmail Android | mobile | Gmail Mobile | PartialSee caveat 1 |
| Gmail iOS | mobile | Gmail Mobile | PartialSee caveat 1 |
| Outlook 365 | webmail | Outlook Web | PartialSee caveat 2 |
| Outlook (New) | desktop | Outlook Web | Unsupported |
| Outlook Classic | desktop | Microsoft Word | Unsupported |
| Outlook iOS | mobile | Outlook Mobile | PartialSee caveat 2 |
| Outlook Android | mobile | Outlook Mobile | PartialSee caveat 2 |
| Outlook for Mac | desktop | WebKit | Supported |
| Apple Mail | desktop | WebKit | Supported |
| Apple Mail iOS | mobile | WebKit | Supported |
| Yahoo Mail | webmail | Yahoo | UnsupportedSee caveat 3 |
| Yahoo Mail Android | mobile | Yahoo | UnsupportedSee caveat 3 |
| Yahoo Mail iOS | mobile | Yahoo | UnsupportedSee caveat 3 |
| Samsung Mail | mobile | Samsung | Supported |
| Thunderbird | desktop | Gecko | Supported |
| HEY Mail | webmail | WebKit | PartialSee caveat 4 |
| Proton Mail | webmail | Proton | Supported |
| AOL Mail | webmail | AOL | UnsupportedSee caveat 3 |
| Fastmail | webmail | Fastmail | Supported |
| Superhuman | desktop | Blink | Unknown |
Documented caveats (4)
- 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.Outlook 365, Outlook iOS, Outlook Android: Partial. Only
<time>is supported. Unsupported opening and closing tags are stripped. - 3.Yahoo Mail, Yahoo Mail Android, Yahoo Mail iOS, AOL Mail: Unsupported opening and closing tags are stripped.
- 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 FreeLast 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.