MailViewr - Free HTML Email Preview Tool

Apple Mail Email Quirks

Known rendering issues, workarounds, and best practices

3 quirks documented

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