Skip to main content
HTML Elements

<dialog>

HTML element · 5 supported, 0 partial, 9 unsupported across 15 clients

The <dialog> element represents a modal or non-modal dialog. It is unsupported in essentially every email client because email is not an interactive surface. Including <dialog> in email markup is harmless — the content inside renders as a regular block — but the open/close behavior never works.

Client Support

ClientCategoryEngineSupport
GmailwebmailGmail WebUnsupported
Gmail AndroidmobileGmail MobileSupported
Gmail iOSmobileGmail MobileUnsupported
Outlook 365webmailOutlook WebUnsupported
Outlook (New)desktopOutlook WebUnsupported
Outlook ClassicdesktopMicrosoft WordUnsupported
Outlook iOSmobileOutlook MobileUnsupported
Outlook AndroidmobileOutlook MobileUnsupported
Apple MaildesktopWebKitSupported
Apple Mail iOSmobileWebKitSupported
Yahoo MailwebmailYahooUnsupported
Samsung MailmobileSamsungSupported
ThunderbirddesktopGeckoSupported
HEY MailwebmailWebKitUnsupported
SuperhumandesktopBlinkUnknown

Client-by-client behaviour for <dialog>

Fully supports <dialog> (5): Gmail Android, Apple Mail, Apple Mail iOS, Samsung Mail, Thunderbird.

No support (9): Gmail, Gmail iOS, Outlook 365, Outlook (New), Outlook Classic, Outlook iOS, Outlook Android, Yahoo Mail, HEY Mail. Plan fallbacks for these clients before relying on <dialog> in production sends.

Behaviour unverified in: Superhuman.

When to use <dialog> in email

  • Including <dialog> as a semantic wrapper for fallback content that renders as block-level text.
  • AMP for Email contexts where lightbox-style interactions are supported (rare and Gmail-only).
  • Future-proofing markup for clients that may eventually honor dialog semantics.

Rendering behaviour and edge cases

  • <dialog> renders as a block-level element with default styling, but no clients honor its open/show behavior.
  • Most clients ignore the open attribute entirely.
  • AMP for Email provides interactive lightboxes through dedicated AMP components, not native <dialog>.

Recommended fallback strategy

Avoid <dialog> in production email. If you need a 'modal' visual treatment, build a styled card with table cells and let it render inline in the email flow.

Fixes & Workarounds

Gmail

Unsupported

"<dialog>" is not supported in this email client.

Gmail iOS

Unsupported

"<dialog>" is not supported in this email client.

Outlook 365

Unsupported

"<dialog>" is not supported in this email client.

Outlook (New)

Unsupported

"<dialog>" is not supported in this email client.

Outlook Classic

Unsupported

"<dialog>" is not supported in this email client.

Outlook iOS

Unsupported

"<dialog>" is not supported in this email client.

Outlook Android

Unsupported

"<dialog>" is not supported in this email client.

Yahoo Mail

Unsupported

"<dialog>" is not supported in this email client.

HEY Mail

Unsupported

"<dialog>" is not supported in this email client.

Related Features

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.