Skip to content

Home Topics Email Marketing Email design and accessibility

Email Marketing · Email design and accessibility

Email design and accessibility not working? Troubleshooting guide

Short answer

When email design and accessibility fails, check in this order: the DNS or platform configuration is published and resolves; the sending system is actually using it; the domain in headers aligns with what you published; and the receiver's verdict in Authentication-Results or bounce messages.

Symptoms#

  • Messages landing in spam despite previously good placement
  • Bounces mentioning policy, authentication, or reputation
  • Provider dashboards showing a drop in reputation or authentication pass rate

Diagnosis steps#

  1. Confirm the configuration is live: query DNS from an external resolver and check the sending platform's settings page.
  2. Send to a seed mailbox and read the full headers, especially Authentication-Results.
  3. Compare the domains in From, Return-Path, and DKIM d= for alignment.
  4. Check provider dashboards (Google Postmaster Tools, Microsoft SNDS) for reputation and error rates.
  5. Review recent changes: new vendors, DNS edits, list imports, volume spikes.

Likely causes#

  • Text embedded in images with no alt.
  • Tiny grey text on light backgrounds.

Fix and re-verify#

  1. Use a single-column layout that reflows on mobile.
  2. Set alt text on every meaningful image and empty alt on decorative ones.
  3. Maintain 4.5:1 contrast and at least 16px body text.
  4. Include a plain-text alternative and test in dark mode.

Frequently asked questions#

Does dark mode change email colors?

Some clients invert or adjust colors. Test in Gmail, Outlook, and Apple Mail dark modes and use transparent PNGs where possible.

Keep reading on Email design and accessibility