CSS At-Rules

@media

CSS at-rule · 8 supported, 0 partial, 7 unsupported across 15 clients

Client Support

Client	Category	Engine	Support
Gmail	webmail	Gmail Web	Unsupported
Gmail Android	mobile	Gmail Mobile	Unsupported
Gmail iOS	mobile	Gmail Mobile	Unsupported
Outlook 365	webmail	Outlook Web	Supported
Outlook (New)	desktop	Outlook Web	Unsupported
Outlook Classic	desktop	Microsoft Word	Unsupported
Outlook iOS	mobile	Outlook Mobile	Supported
Outlook Android	mobile	Outlook Mobile	Supported
Apple Mail	desktop	WebKit	Supported
Apple Mail iOS	mobile	WebKit	Supported
Yahoo Mail	webmail	Yahoo	Unsupported
Samsung Mail	mobile	Samsung	Supported
Thunderbird	desktop	Gecko	Unsupported
HEY Mail	webmail	WebKit	Supported
Superhuman	desktop	Blink	Supported

Client-by-client behaviour for @media

Fully supports @media (8): Outlook 365, Outlook iOS, Outlook Android, Apple Mail, Apple Mail iOS, Samsung Mail, HEY Mail, Superhuman.

No support (7): Gmail, Gmail Android, Gmail iOS, Outlook (New), Outlook Classic, Yahoo Mail, Thunderbird. Plan fallbacks for these clients before relying on @media in production sends.

Fixes & Workarounds

Gmail

Unsupported

Design emails mobile-first with a single-column layout that works without media queries.

Before

<table width="800">
  <tr>
    <td width="400">Left Column</td>
    <td width="400">Right Column</td>
  </tr>
</table>
<style>
  @media (max-width: 600px) {
    table { width: 100% !important; }
    td { display: block !important; width: 100% !important; }
  }
</style>

After

<!-- Single-column layout that works without @media -->
<table role="presentation" width="100%"
  style="max-width: 600px;" cellpadding="0"
  cellspacing="0" border="0">
  <tr>
    <td style="padding: 16px;">Left Column</td>
  </tr>
  <tr>
    <td style="padding: 16px;">Right Column</td>
  </tr>
</table>

Design mobile-first for clients without media query support

Gmail Android

Unsupported

Design emails mobile-first with a single-column layout that works without media queries.

Before

<table width="800">
  <tr>
    <td width="400">Left Column</td>
    <td width="400">Right Column</td>
  </tr>
</table>
<style>
  @media (max-width: 600px) {
    table { width: 100% !important; }
    td { display: block !important; width: 100% !important; }
  }
</style>

After

<!-- Single-column layout that works without @media -->
<table role="presentation" width="100%"
  style="max-width: 600px;" cellpadding="0"
  cellspacing="0" border="0">
  <tr>
    <td style="padding: 16px;">Left Column</td>
  </tr>
  <tr>
    <td style="padding: 16px;">Right Column</td>
  </tr>
</table>

Design mobile-first for clients without media query support

Gmail iOS

Unsupported

Design emails mobile-first with a single-column layout that works without media queries.

Before

<table width="800">
  <tr>
    <td width="400">Left Column</td>
    <td width="400">Right Column</td>
  </tr>
</table>
<style>
  @media (max-width: 600px) {
    table { width: 100% !important; }
    td { display: block !important; width: 100% !important; }
  }
</style>

After

<!-- Single-column layout that works without @media -->
<table role="presentation" width="100%"
  style="max-width: 600px;" cellpadding="0"
  cellspacing="0" border="0">
  <tr>
    <td style="padding: 16px;">Left Column</td>
  </tr>
  <tr>
    <td style="padding: 16px;">Right Column</td>
  </tr>
</table>

Design mobile-first for clients without media query support

Outlook (New)

Unsupported

Design emails mobile-first with a single-column layout that works without media queries.

Before

<table width="800">
  <tr>
    <td width="400">Left Column</td>
    <td width="400">Right Column</td>
  </tr>
</table>
<style>
  @media (max-width: 600px) {
    table { width: 100% !important; }
    td { display: block !important; width: 100% !important; }
  }
</style>

After

<!-- Single-column layout that works without @media -->
<table role="presentation" width="100%"
  style="max-width: 600px;" cellpadding="0"
  cellspacing="0" border="0">
  <tr>
    <td style="padding: 16px;">Left Column</td>
  </tr>
  <tr>
    <td style="padding: 16px;">Right Column</td>
  </tr>
</table>

Design mobile-first for clients without media query support

Outlook Classic

Unsupported

Design emails mobile-first with a single-column layout that works without media queries.

Before

<table width="800">
  <tr>
    <td width="400">Left Column</td>
    <td width="400">Right Column</td>
  </tr>
</table>
<style>
  @media (max-width: 600px) {
    table { width: 100% !important; }
    td { display: block !important; width: 100% !important; }
  }
</style>

After

<!-- Single-column layout that works without @media -->
<table role="presentation" width="100%"
  style="max-width: 600px;" cellpadding="0"
  cellspacing="0" border="0">
  <tr>
    <td style="padding: 16px;">Left Column</td>
  </tr>
  <tr>
    <td style="padding: 16px;">Right Column</td>
  </tr>
</table>

Design mobile-first for clients without media query support

Yahoo Mail

Unsupported

Design emails mobile-first with a single-column layout that works without media queries.

Before

<table width="800">
  <tr>
    <td width="400">Left Column</td>
    <td width="400">Right Column</td>
  </tr>
</table>
<style>
  @media (max-width: 600px) {
    table { width: 100% !important; }
    td { display: block !important; width: 100% !important; }
  }
</style>

After

<!-- Single-column layout that works without @media -->
<table role="presentation" width="100%"
  style="max-width: 600px;" cellpadding="0"
  cellspacing="0" border="0">
  <tr>
    <td style="padding: 16px;">Left Column</td>
  </tr>
  <tr>
    <td style="padding: 16px;">Right Column</td>
  </tr>
</table>

Design mobile-first for clients without media query support

Thunderbird

Unsupported

Design emails mobile-first with a single-column layout that works without media queries.

Before

<table width="800">
  <tr>
    <td width="400">Left Column</td>
    <td width="400">Right Column</td>
  </tr>
</table>
<style>
  @media (max-width: 600px) {
    table { width: 100% !important; }
    td { display: block !important; width: 100% !important; }
  }
</style>

After

<!-- Single-column layout that works without @media -->
<table role="presentation" width="100%"
  style="max-width: 600px;" cellpadding="0"
  cellspacing="0" border="0">
  <tr>
    <td style="padding: 16px;">Left Column</td>
  </tr>
  <tr>
    <td style="padding: 16px;">Right Column</td>
  </tr>
</table>

Design mobile-first for clients without media query support

Production guidance for @media

@media is a CSS at-rule. Across the email client matrix, 8 of 15 tracked clients support it fully, 0 only partially, and 7 not at all. The clients most likely to require a workaround for this feature are Gmail, Gmail Android, Gmail iOS. Each of them needs a tailored fallback — see the per-client examples above for the specific code fix Emailens recommends.

When in doubt, ship a baseline that renders without @media and treat it as progressive enhancement on clients where support is verified. Emailens automatically detects cross-client divergence on this feature when you preview an email, so you can see exactly which template paths break before a campaign goes out.

Related Features

@font-face @import @keyframes @supports

Test your email across all 15 clients

Preview rendering, catch CSS issues, and get actionable fixes — free.

Try Emailens Free

Support data last updated Apr 27, 2026 · synced from caniemail.com via @emailens/engine.