Overview
Apple Mail on macOS and iOS has good CSS support, but has some quirks unique to WebKit.
Documented Quirks
1
Apple Mail and Absolute Positioning
macOSiOS
Issue
Absolute positioning doesn't work as expected in Apple Mail; elements may overlap or disappear.
Workaround
Use relative positioning or float-based layouts instead. Test carefully.
2
Apple Mail Text Detectors
macOS 10.5+iOS 2.0+
Issue
Apple Mail automatically detects phone numbers, dates, and addresses, turning them into links and modifying styling.
Workaround
Use meta tag to disable auto-detection or wrap detected text in spans with specific styles.
Code Example
<!-- Disable auto-detection --> <meta name="format-detection" content="telephone=no"> <meta name="format-detection" content="date=no"> <meta name="format-detection" content="address=no">
3
Apple Mail and Inline Block Display
macOSiOS
Issue
display: inline-block sometimes renders with unexpected spacing in Apple Mail.
Workaround
Use font-size: 0 on parent to eliminate whitespace between inline-block elements.
Code Example
/* ✓ GOOD: Remove whitespace between inline-block items */
.container {
font-size: 0;
}
.item {
display: inline-block;
font-size: 14px;
width: 50%;
}Related Resources
- All Email Client Quirks — Browse quirks for other email clients
- CSS Support Matrix — See detailed CSS property compatibility
- Email Client Support Matrix — Compare feature support across clients
- Apple Mail CSS Support — Full CSS property breakdown for Apple Mail