Google Postmaster Tools: The Complete 2026 Guide

Google Postmaster Tools is Google's free dashboard for anyone sending email to Gmail: verify your domain with a DNS record and it shows you how Gmail sees your mail — user-reported spam rate, SPF/DKIM/DMARC pass rates, TLS encryption, delivery errors, and whether you meet Gmail's sender requirements. It is the most authoritative source of Gmail deliverability data available, and also the most misdescribed: most guides ranking for this term still teach the Domain Reputation and IP Reputation dashboards, which Google removed when it retired the old interface in late 2025. This guide covers the current version — how to set it up, how to read every dashboard that still exists, and what Postmaster Tools can no longer tell you.

The 2025 reset: why most guides are now wrong

Google retired the original Postmaster Tools in stages: the v1 web interface shut down on 30 September 2025, and the v1 API followed on 31 October 2025 according to SendGrid's account of the transition (the API date is vendor-reported; as of August 2026 Google's own API reference still documents v1 with no published sunset notice, so treat the exact API cutoff as murky).

What is not murky is the headline change. Google's own deprecation notice states: "All the dashboards in old Postmaster Tools are available in v2, with the exception of the Domain and IP Reputation dashboards, which will be retired" (Google Workspace Admin Help). The four-bucket Bad/Low/Medium/High reputation rating — the single most screenshot-ed chart in email deliverability — is gone.

Google's stated reasons, from the same notice: reputation data "is not easily actionable for most senders," changes in sender behavior "are slow to reflect in the existing dashboard," and the dashboard "can be misleading as reputation is only one of many factors affecting deliverability." Google also said it introduced "a new, more intuitive version" of reputation metrics without specifying what that means — worth watching, but as of August 2026 no bucket-style reputation view has returned.

The practical consequence: "get your domain to High in Postmaster Tools" is no longer an observable goal. Anything published before late 2025 — including, confusingly, some of Google's own help pages, which still described the old dashboard lineup as of August 2026 — is describing a product that no longer exists. The observables that replaced it are covered below.

Setting it up: domain verification

Setup takes about ten minutes:

1. Sign in at postmaster.google.com/v2/manage_domains with any Google account.
2. Click Add new domain and enter the domain you authenticate with — the DKIM d= domain (or SPF domain), not necessarily the domain in your visible From address.
3. Google gives you a TXT or CNAME record. Add it at your DNS provider, then click Verify. Google says verification is usually immediate but "can take up to 10 minutes".

Two details matter more than most walkthroughs admit:

• Verify the domain your mail is actually authenticated with. Postmaster Tools data is keyed to the authenticated domain. If you send through an ESP and your DKIM signature still uses the ESP's shared domain rather than your own, you will be looking at the ESP's aggregate data, not yours. Set up custom DKIM for your domain first — you can confirm what your SPF, DKIM, and DMARC records currently say with our free domain checker.
• Subdomains inherit verification. If the parent domain is already verified — including via Google Workspace — subdomains do not need separate verification. Useful if you send from mail.yourdomain.com, as most outreach setups do.

The dashboards that exist in 2026

The current version has six dashboards (Google's dashboard documentation):

Dashboard	What it measures	Healthy reading
Compliance status	Pass/fail against Gmail's sender requirements, per check	Everything green
Spam rate	% of inbox-delivered, DKIM-authenticated mail that recipients marked as spam	< 0.10%, never 0.30%
Authentication	% of mail passing SPF, DKIM, DMARC	≥ 95% for DKIM and DMARC
Encryption	% of mail sent over TLS, inbound and outbound	~100%
Delivery errors	% of authenticated mail rejected or temp-failed, with reasons	Near zero
Feedback loop	Spam rates per Feedback-ID campaign identifier	No flagged campaigns

Compliance status

The closest thing to a replacement for the reputation dashboards. It grades your primary domain against Gmail's sender requirements as COMPLIANT or NEEDS_WORK per requirement — the Postmaster Tools API v2 exposes eleven checks: SPF, DKIM, SPF and DKIM together, DMARC policy, DMARC alignment, message formatting (RFC 5322), DNS records (forward and reverse), TLS encryption, user-reported spam rate, one-click unsubscribe, and honoring unsubscribe requests. Note that the old dashboard had four reputation buckets; this has two states. It answers "am I meeting the requirements?", not "how much does Gmail like me?" — those are different questions, and Gmail now only answers the first.

If anything here shows NEEDS_WORK, fix it before anything else — the requirements are gates, and the fixes are covered step-by-step in how to improve email deliverability.

Spam rate

The single most important chart. Google defines it as "the percent of your messages that are delivered to engaged recipient's Inbox and then marked as spam by the recipient", counted over DKIM-authenticated mail only, and calculated daily.

The thresholds are the only hard public numbers in Gmail deliverability: "Keep spam rates reported in Postmaster Tools below 0.10%" and "avoid ever reaching a spam rate of 0.30% or higher". Crossing 0.3% has a documented penalty: bulk senders above it are ineligible for delivery mitigation until their spam rate stays below 0.3% for 7 consecutive days. There is no "we fixed it, let us back in" path — the gate is time-based.

Two subtleties that trip nearly everyone:

• The denominator is inbox-delivered mail. Messages Gmail routes straight to spam are never seen or reported by recipients, so they don't enter the calculation — this is the consistent practitioner reading of Google's definition, though Google doesn't spell it out. A domain already being spam-foldered can therefore show a deceptively low spam rate. 0.0% does not mean you are inboxing.
• At low volume the metric is statistically meaningless. 0.3% is 3 complaints per 1,000 delivered; at 50 messages a day, a single complaint blows past it. Google itself ships a 95% confidence interval on this metric in the API (userReportedSpamRatioLowerBound/UpperBound) — an admission that the point estimate is noisy.

Authentication

Shows the percentage of your mail passing SPF, DKIM, and DMARC. Google's expectation is 95% or higher for DKIM and DMARC when correctly configured; SPF typically runs lower because forwarding breaks it. A sudden dip usually means a new sending service was added without updating DNS, or a DKIM key was rotated incorrectly — not a reputation event.

Encryption

The percentage of your authenticated mail transmitted over TLS. This should sit at effectively 100% with any modern ESP; TLS is one of the eleven compliance checks, so a drop here is a compliance problem, not a nice-to-have.

Delivery errors

The percentage of authenticated mail Gmail rejected or temporarily failed, broken down by reason. The API's error taxonomy names ten types, including RATE_LIMIT_EXCEEDED, SUSPECTED_SPAM, LOW_IP_REPUTATION, LOW_DOMAIN_REPUTATION, IP_IN_RBL, DOMAIN_IN_RBL, and BAD_PTR_RECORD. Read that list carefully: Gmail still computes IP and domain reputation internally — LOW_DOMAIN_REPUTATION remains a first-class rejection reason. What changed in 2025 is that you can no longer watch the score; you only see its consequences here.

Feedback loop

Not a feedback loop in the industry sense. A true FBL (Microsoft's JMRP, Yahoo's CFL) tells you which recipient complained so you can suppress them. Gmail's version is aggregate only: you add a Feedback-ID header — four colon-separated fields, of which the rightmost SenderId (5–15 characters) is mandatory — and Postmaster Tools shows spam rates per identifier. Reports are only generated when an identifier appears in enough mail and enough distinct spam reports, and Google explicitly warns against per-message-unique IDs, which guarantee you see nothing. Useful for spotting which campaign is generating complaints; useless for suppressing complainers.

How much volume before data appears

The most-asked question, and the honest answer is: Google does not publish a number. The "100 emails/day" and "5,000/day" figures circulating in vendor blogs are folklore. What Google actually says is that "data might be missing if the total number of messages for a given day is too low" and that it may exclude data on low-volume days to protect user privacy.

The mechanism is privacy-based suppression, not a fixed floor — Google withholds data whenever publishing it could deidentify recipients. In practice that means the threshold differs per dashboard (spam rate needs enough complaints to be non-identifying, so it populates later than most), and varies day to day with your volume mix.

For a domain in early warmup, this has a blunt consequence: empty dashboards are the expected state, not a malfunction. A sender at 20–50 messages a day should expect no data at all for weeks. WarmEnvelopes' warmup sends sit in exactly this range by design, which is why we tell users to treat Postmaster Tools as the scoreboard for later, once real campaign volume flows — not as a warmup progress meter.

Also budget for lag. Google states dashboards are typically updated within 24 hours but can take longer, and that spam rate and feedback loop changes take up to 7 days to be reflected. If you fix a problem on Monday, judging the fix on Tuesday is meaningless — wait the week out before concluding anything.

Where to look for reputation signals now

With the reputation buckets gone, the working substitute (as of August 2026) is a composite:

• Spam rate trend — the input Google kept a hard number for, and the closest daily proxy for how Gmail's filters are scoring you.
• Compliance status — binary, but a NEEDS_WORK on any check is a concrete, fixable deliverability problem.
• Delivery errors — the place reputation damage becomes visible. A rising LOW_DOMAIN_REPUTATION or SUSPECTED_SPAM share is the old Low/Bad bucket showing itself through effects.
• SMTP rejection codes in your ESP logs — Gmail's error catalogue still returns explicit verdicts like 421 4.7.0 "very low reputation of the sending domain." Your send logs contain reputation feedback the dashboards no longer chart.
• Outside Google: Cisco Talos gives a free per-domain and per-IP score (−10 to +10, bucketed Good/Neutral/Poor — but note low volume alone yields "Neutral"), the Spamhaus DBL is the authoritative domain blocklist lookup, and Yahoo's Complaint Feedback Loop is the one major per-complaint FBL keyed to your DKIM domain rather than an IP, so shared-pool ESP senders can actually use it.

None of these individually replaces the old dashboard; together they cover most of what it showed.

What Postmaster Tools cannot tell you

Honest limits, because the tool is routinely oversold:

• It cannot show inbox placement. No dashboard reports what percentage of your mail landed in the inbox versus spam for real recipients — Gmail exposes an aggregate spam rate, not folder placement, and a clean spam rate is compatible with heavy spam-foldering because of the denominator problem above. Understanding what placement can and cannot be measured is its own topic: see inbox placement rates.
• It cannot tell you who complained. Aggregate by design; per-recipient suppression is possible at Microsoft and Yahoo, impossible at Gmail.
• It covers Gmail only. Outlook, Yahoo, and — critically for B2B — corporate gateways like Proofpoint and Mimecast publish no equivalent sender dashboards. A perfect Postmaster picture says nothing about half your list.
• It goes blind exactly when you most want data. Below the unpublished privacy threshold you get nothing, and the warmup phase of a new domain sits below it by definition.
• It measures your authenticated domain. If your DKIM d= is your ESP's shared domain, every chart describes the ESP's traffic, not yours.

Used within those limits — the right domain verified, enough volume flowing, spam rate read with its denominator caveat, and a seven-day patience rule after any change — Postmaster Tools is still the best free instrument in email deliverability. Just stop looking for the reputation dashboard. It isn't coming back in the form the old guides describe.