How to test plain-text fallback?

Still have a question, spotted an error, or have a better explanation or a source we should cite?

Your HTML email needs a plain-text version as backup. Some email clients won't render HTML, and some users prefer text-only. To test it, you need to see what your plain-text version actually looks like in the wild.

Most email clients let you switch to plain-text mode. Check your email app's settings. In Gmail, look for "Display email as text" in message options. Outlook and Apple Mail have similar toggles. Once enabled, open one of your sent emails. If the text reads naturally without HTML artifacts, you're good. If you see raw HTML tags or mangled links, you've got a problem.

For deeper inspection, check the raw MIME source. Every email has a behind-the-scenes structure with both HTML and text parts. Your ESP or email client usually has a way to view this. Look for the text/plain section and read it line by line. Does it make sense? Are links formatted clearly? Is important content missing?

And Here's the key issue. Most ESPs auto-generate plain text from your HTML. This almost always produces garbage: navigation becomes random lists, buttons turn into bare URLs, and formatting disappears. The fix is to hand-write your plain-text version. Treat it as a standalone email, not a stripped-down version. Write it to flow logically without any visual design helping readers understand it.

What to include. Full URLs where links belong (not just "click here"), strategic line breaks for readability, and clear section breaks using dashes or blank lines. Test on a few popular clients. Plain-text fallback isn't just a legal checkbox. It's a real email experience that real people use.

Related: pre-send testing, dark mode testing, A/B testing.

Contributors

Who worked on this answer

Every name links to their profile. Every company links to their site. Real people, real accountability.

Ask an AI · tailored to your setup

Get step-by-step instructions tailored to your setup.

I read this on the Email Almanac about testing plain-text fallback: "View your email in text-only mode or check the raw MIME source to see the plain-text version. Hand-craft it rather than relying on auto-generation." Give me step-by-step instructions for MY specific setup: 1. What exactly to do in my ESP or email client 2. Common issues to watch for 3. How to verify it's working 4. What to do if it's broken --- My details (fill in what applies, the more you share, the better the advice): - Email platform/ESP: e.g. Mailchimp, SendGrid, Postmark, HubSpot, custom SMTP - Domain(s): your sending domain(s) - Sending volume: e.g. 5,000/month or 500/day - Type of email: newsletter / promotional / transactional / automated series - Design approach: [HTML template / drag-and-drop builder / plain text / custom coded] - Template tool: ESP builder, MJML, Stripo, Bee, custom HTML - Image hosting: ESP / CDN / inline / base64 - Personalization used: first name, dynamic content, product recs, none - Dark mode support: yes / no / unsure - Accessibility considerations: yes / no / trying to improve - Target audience: B2B / B2C / mixed, describe typical reader - Brand guidelines: strict / flexible / none - Current challenge: [spam filters, rendering issues, low engagement, design consistency]

Edit the yellow boxes, then send to the AI of your choice.