Email Clients
Gmail
Gmail Web, Gmail Android, and Gmail iOS rendering behavior and CSS support.
Gmail is one of the most restrictive email clients for CSS support. Emailens covers three Gmail variants.
Variants
| ID | Platform | Engine |
|---|---|---|
gmail-web | Webmail (browser) | Gmail Web |
gmail-android | Android app | Gmail Mobile |
gmail-ios | iOS app | Gmail Mobile |
All three support dark mode, but behave differently: Gmail Web only darkens the UI chrome (email content is unchanged), Gmail iOS applies full color inversion, and Gmail Android applies partial inversion.
Key behaviors
- Strips
<style>blocks — Gmail removes<style>tags in most contexts. All CSS must be inlined. - Strips class attributes — CSS classes are removed, making class-based styling unreliable.
- No flexbox or grid —
display: flexanddisplay: gridare unsupported. Use tables for layout. - No
position—position: relative/absolute/fixedis stripped. - No
box-shadow— shadows are completely removed. - No
opacity— transparency is not supported. - Limited
background-image— background images have partial support (inline only). - No
border-radius— rounded corners are stripped. - Limited
margin— negative margins and margin on certain elements are unreliable.
Recommendations
- Use inline styles for all critical styling
- Use table-based layouts instead of flexbox/grid
- Use solid background colors instead of background images
- Avoid border-radius — use images for rounded elements if needed
- Test both light and dark mode variants