Repository navigation
Email Accessibility
github-actions[bot] edited this page Oct 29, 2026
·
3 revisions
Audits HTML email templates for accessibility under email client rendering constraints. Covers table-based layout, inline styling, image blocking fallbacks, semantic structure, dark mode adaptation, and screen reader compatibility across Outlook, Gmail, and Apple Mail.
- Audits email HTML for semantic heading structure and reading order
- Validates layout tables have
role="presentation"to suppress table semantics - Checks all images for alt text and image blocking fallbacks
- Reviews link text for clarity and uniqueness
- Audits color contrast under both light and dark mode rendering
- Tests against email client constraints (no CSS grid/flex, inline styles required)
- Supports MJML, Foundation for Emails, and raw HTML email templates
- Building or reviewing HTML email templates for accessibility
- Checking screen reader compatibility across major email clients
- Ensuring images have fallback text when image blocking is enabled
- Auditing dark mode rendering for contrast and readability
- Reviewing table-based layouts for correct linearized reading order
- Template detection - Identifies the email framework (MJML, Foundation, raw HTML)
- Semantic audit - Checks heading hierarchy, paragraph structure, and language attribute
-
Layout audit - Validates all layout tables use
role="presentation"and reading order is logical when linearized - Image audit - Checks alt text, decorative image handling, and image blocking fallback behavior
- Link audit - Reviews link text for ambiguity and checks that links are distinguishable
- Color and contrast audit - Tests text contrast, verifies dark mode overrides do not break readability
- Client compatibility notes - Flags patterns known to fail in specific email clients
Each direction, with its agent and when.
| Direction | Agent | When |
|---|---|---|
| Receives from | accessibility-lead | When email templates are identified in a web audit scope |
| Hands off to | accessibility-lead | When web-based email issues require general web audit |
| Hands off to | alt-text-headings | When email images need detailed alt text review |
/email-accessibility Audit this MJML email template for screen reader accessibility
/email-accessibility Check our newsletter HTML for image blocking fallbacks and dark mode support
/email-accessibility Review this transactional email template for Outlook compatibility
- accessibility-lead - Coordinates full web accessibility audits
- alt-text-headings - Image alt text and heading structure review
- contrast-master - Color contrast verification, useful for dark mode email testing
- link-checker - Ambiguous link text detection in email content
- Agents Overview
- Accessibility Lead
- Web Accessibility Wizard
- Document Accessibility Wizard
- Markdown Assistant
- Developer Hub
- GitHub Hub