Gmail vs Apple Mail: CSS Support Differences
Gmail renders with Gmail Web; Apple Mail renders with WebKit. The gap runs almost entirely one way: 115 features work in Apple Mail and break in the other, against 1 in the reverse direction. Build for the stricter one and the permissive one follows.
Support data derived from caniemail.com (MIT) - last synced Sep 2, 2026 - engine data v0.12.2
149
work in both
the safe intersection
1
only in Gmail
breaks in Apple Mail
115
only in Apple Mail
breaks in Gmail
29
partial on one side
renders, with caveats
Works in Gmail, breaks in Apple Mail
Each of these needs a fallback if the send reaches both.
Works in Apple Mail, breaks in Gmail
- <audio>
- <bdi>
- <dialog>
- <link>
- <marquee>
- <meter>
- <progress>
- <rp>
- <rt>
- <ruby>
- <video>
- [aria-describedby]
- [aria-labelledby]
- [command]
- [hidden]
- [loading]
- [popover]
- [required]
- [srcset]
- @font-face
- @import
- @keyframes
- @media device-pixel-ratio
- @media hover
- @media prefers-color-scheme
- @media prefers-reduced-motion
- @supports
- accent-color
- align-items
- animation
- aspect-ratio
- backdrop-filter
- block-size
- border-image
- border-inline
- border-inline-individual
- border-inline-longhand
- border-radius-logical
- bottom
- box-shadow
- clip-path
- color-scheme
- conic-gradient
- custom-properties
- filter
- flex-direction
- flex-wrap
- grid-template-columns
- hyphenate-character
- hyphens
- inert
- inset
- justify-content
- left
- light-dark
- list-style-image
- margin-block-start-end
- margin-inline-block
- margin-inline-start-end
- mask-image
- max-block-size
- max-inline-size
- meta-color-scheme
- min-block-size
- min-inline-size
- modern-color
- orphans
- outline-offset
- padding-block-start-end
- padding-inline-block
- padding-inline-start-end
- pseudo-class-default
- pseudo-class-nth-last-of-type
- right
- scroll-snap
- shape-margin
- shape-outside
- tab-size
- text-decoration-skip-ink
- text-decoration-thickness
- text-emphasis-position
- text-shadow
- text-underline-offset
- text-wrap
- top
- transform
- transition
- user-select
- visibility
- white-space-collapse
- widows
- z-index
- ::after
- ::before
- ::first-letter
- ::first-line
- ::marker
- ::placeholder
- :checked
- :first-child
- :first-of-type
- :focus
- :focus-visible
- :focus-within
- :has
- :lang
- :last-child
- :last-of-type
- :link
- :not
- :nth-child
- :nth-last-child
- :nth-of-type
- :only-child
- :only-of-type
Partial on one side
These render in both, but one client applies caveats the other does not. They fail quietly, which makes them the expensive ones.
A further 4 features render in neither client. Not a difference between them, but the other half of the answer to what you can actually use, so the four counts above deliberately do not sum to 298.
Where the divergence sits
Two pairs with the same headline number can be different problems. For these two it concentrates in CSS Properties.
- CSS Properties 78
- Pseudo-Classes & Selectors 21
- HTML Elements 18
- HTML Attributes 9
- CSS At-Rules 9
- Pseudo-Elements 6
8 of these already have a fix
Each links to a copy-paste snippet that keeps the feature working in Apple Mail without dropping it in Gmail.
Check your own HTML against both
Check your own HTML
Paste your own, or run the sample below. Analyzed in this page, with no signup and nothing stored.
Questions
- How different are Gmail and Apple Mail?
- They disagree on 145 of the 298 features verified in both clients, or 49%. 149 features render in both and are the safe intersection to build on.
- What works in Gmail but not Apple Mail?
- 1 features, including amp4email. Each needs a fallback if the send reaches both clients.
- Which engines are these two clients using?
- Gmail renders with Gmail Web; Apple Mail renders with WebKit. Where two clients share an engine the divergence is usually configuration, and where they do not it is the engine itself.
- Is this measured in the real clients?
- No. These are documented support levels derived from caniemail.com (MIT-licensed), carried in @emailens/engine data version 0.12.2 and last synced Sep 2, 2026. That sync date is not a test date: caniemail's own per-feature tests run from Feb 28, 2019 to Jul 13, 2026. Anything described as a transform is applied per those documented rules rather than captured from a real client.
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.
Instant live preview · No signup required · 21 email engines