Skip to content
email-deliverabilityecommercemonitoringsender-reputation

Email Deliverability Postmortem Template

After the first 24 hours, write down which provider moved, what you ruled out, and how you will know the fix held. Here is a short postmortem that does not invent a recovery date.

Udhayakumar M

3 min read

Email Deliverability Postmortem Template
On this page

Your incident is over when somebody in the channel says it is over, unless you wrote down what “over” means. Otherwise the next sale repeats the same send, to the same cold slice, on the same domain, and the Slack thread starts from zero.

The first 24 hours is the response. This page is the document you write after that, while the logs still exist.

Last verified: 26 September 2026. The template does not add recovery-time claims. Providers still do not publish one.

Copy this deliverability postmortem structure

Title. One sentence: what stopped, for whom, on which date. “Gmail spam rate crossed 0.30% on the Saturday sale, 12 September 2026” is a title. “Email issues” is not.

Timeline. Hour the first signal moved. Hour someone noticed. Hour the send was stopped. Hour the change shipped. Hour you retested. Pull times from Postmaster, Sender Hub, the bounce log, or seed results. The incident agent keeps an audit history of signals and remediation if it was on. That history is an input. It is not the postmortem.

Scope. Which From domain, which IP or ESP, which stream (campaign, flow, receipt), which providers. A Gmail-only event is not an Outlook event. Use the provider split so the scope line names a provider.

Impact. Orders or tickets you can count. If you estimate revenue, use your own inputs the way deliverability ROI describes. Do not convert a bounce rate into lost revenue. Do not cite a sitewide spam percentage as your incident.

Cause. The mechanism you can point at: a list import, a broken DKIM selector, a volume step, a complaint spike on a win-back, a 5xx policy. Quote the SMTP text or the provider chart. One cause.

Ruled out. Authentication passed or failed, and you looked. A domain scan of SPF, DKIM, DMARC, and blocklists gives you one dated snapshot to paste here. No new list, or there was a new list. Content was or was not the only thing that changed. This section is how the next person skips the myth you already killed. Content versus reputation is the background, not a required paragraph.

Change. What you stopped, suppressed, or fixed in DNS. Link the runbook you actually followed.

Verification. The signal that has to hold before volume comes back. “Gmail spam rate under 0.10%” is a verification line; “wait 30 days” is not. Keep the caveat in the document: 0.10% is Google’s guideline, not a requirement, and meeting it says your complaints are down, not that placement has returned. Other examples that are real: Yahoo complaint rate under 0.30%, no new 5.7.515, seed placement at Gmail and Yahoo back to the pre-incident pattern. Recovery time explains why “wait 30 days” is not a verification.

Monitor. Who looks at which tool on the next three sends. Monitoring across providers is the assignment list.

What does not belong

A blame paragraph. A new sending domain created during the incident and described as the fix, unless you planned that cutover and authenticated it. A promise that placement is “back to 100%.” Seed tests are a sample at Gmail, Yahoo, AOL, and Outlook. They are not the whole list.

InboxEagle

Fill in the ruled-out section with evidence

Scan your domain for SPF, DKIM, DMARC, and blocklist status, and paste the dated result into the postmortem. Then the next person knows authentication was checked, not assumed.

Sources

Frequently Asked Questions

When should I write a deliverability postmortem?
After the sending incident is contained, not during the first hour. The first 24 hours page is the response. The postmortem is the record: what broke, which provider, what you changed, and which signal will tell you it stayed fixed. Write one when mail was rejected, when placement dropped, or when a complaint or bounce rate crossed a provider's published line.
What belongs in the postmortem?
A timeline, the scope (which stream, which provider, which audience), the cause you can support with a log or a provider tool, the causes you ruled out, the change you shipped, how you verified it, and the monitor you will keep. Leave out a recovery date the provider did not publish.
Does InboxEagle write the postmortem for me?
The incident agent records signals, remediation, and an audit history, and it can alert in Slack or email. The postmortem is still a human document. Use the agent history as the timeline. Do not treat an alert as the root cause until the bounce text or the provider tool agrees.
Udhayakumar M
Udhayakumar M·Content Marketer

With 8+ years writing for 80+ SaaS products, Udhay knows how to make complex ideas land. At InboxEagle, he turns email deliverability data into plain-English strategy — helping eCommerce brands understand why emails end up where they do, and what to do about it.

LinkedIn
Share this article:Share on XShare on LinkedIn
Explore with AI

Open this content in your AI assistant for deeper analysis, or copy it as Markdown to paste anywhere.

ChatGPTClaudePerplexity

Related Articles

One deliverability insight, every Friday.

Trusted by 2,000+ email senders. Free, always.

Free Checklist

The exact checklist used by 2,000+ email senders to diagnose and fix inbox placement issues — free.

  • Authentication setup (SPF, DKIM, DMARC)
  • Sender reputation signals to monitor
  • List hygiene benchmarks
  • Content & engagement red flags

No spam. Unsubscribe any time.