Docs

Deliverability testing: send the real email and fix the highest-risk signals.

Learn how WillItInbox test inboxes work, what the report checks, how to validate supporting lists, and how to retest after fixes.

0-100

weighted score

5

score categories

24h

short raw email retention

How the test flow works

WillItInbox generates a unique test address. You send a message to that address from the exact app, ESP, domain, and template you want to evaluate. The report analyzes what a receiver can see.

  • Generate a unique inbox for a single test.
  • Send the same message your customers would receive.
  • Review authentication, DNS, headers, content, links, score, and prioritized fixes.

What the report checks

The score is intentionally weighted toward signals mailbox providers care about before content reputation can help you.

Authentication

SPF, DKIM, DMARC, alignment, policy strength, selector lookup, and BIMI signals.

Infrastructure

PTR, forward-confirmed rDNS, HELO, MX, DNSBLs, dynamic IP signals, and TLS.

Message quality

Required headers, SpamAssassin signals, MIME shape, unsubscribe, address, attachments, and links.

When to re-test

Run a fresh test after meaningful DNS, ESP, template, domain, or sending infrastructure changes. Do not treat one old report as proof that future campaigns are safe.

  • After SPF, DKIM, or DMARC changes propagate.
  • Before a large newsletter or lifecycle campaign.
  • After changing ESPs, tracking domains, templates, or link destinations.

Pre-send workflow

Use deliverability testing as launch QA

The docs should teach a repeatable operating loop: send the real message, fix durable failures, validate the recipient list, retest after changes, and keep the report as evidence.

MomentCheckDestination
Before template launchFinal message through the real sender path./tools/email-deliverability-tester
Before campaign volumeList validation and risky recipient segmentation./tools/email-validator
Before bulk sendsList-Unsubscribe, MIME, links, image ratio, and sender requirements./tools/header-analyzer
After fixesRetest and compare report evidence./examples/sample-deliverability-report

Limits

Document diagnostic evidence without overpromising placement

WillItInbox can expose technical risk and obvious spam signals. It should not claim to guarantee inbox placement because reputation, engagement, recipient history, and provider behavior remain separate inputs.

  • Use the report to block clear technical failures before launch.
  • Use domain monitoring and provider dashboards for ongoing reputation context.
  • Use validation before sending to stale or imported lists.

Evidence quality

A deliverability test is only useful when it uses the real send path

A forwarded proof, pasted HTML body, or staging message through a different sender can hide the exact problems that mailbox providers will see. The strongest test uses the production-like application, ESP, sender domain, DKIM selector, Return-Path, tracking links, and final template.

  • Generate a fresh test address in /test.
  • Send the message from the same system that will send to users or subscribers.
  • Review the sample report to understand how category scores become prioritized fixes.

Fix order

Prioritize receiver gates before polish

Authentication and infrastructure failures usually deserve attention before content refinements because receivers evaluate sender identity and connection quality before trusting the body. After that, required headers, unsubscribe handling, MIME quality, and links shape the final risk profile.

LayerCommon issueFirst action
AuthenticationSPF/DKIM/DMARC missing or unalignedFix DNS/provider configuration, then retest.
InfrastructurePTR, HELO, TLS, or blocklist issueCorrect the sender host or investigate the listing cause.
HeadersMissing List-Unsubscribe or Message-IDFix the mailer or ESP template settings.
ContentHTML-only, image-heavy, or suspicious linksImprove MIME structure and link hygiene.

FAQ

Does the deliverability test guarantee inbox placement?

No. It shows technical deliverability signals and likely risk. Inbox placement still depends on reputation, engagement, recipient history, and provider behavior.

Should transactional and marketing messages be tested separately?

Yes. They often use different templates, headers, links, subdomains, and sending systems.

When should I rerun a deliverability test?

Retest after DNS changes, ESP migrations, template edits, tracking-domain changes, new sending subdomains, and before important campaigns or product-email releases.

Should transactional and marketing email be tested separately?

Yes. They often use different templates, headers, links, sender domains, and risk profiles.