Gmail Postmaster Tools Setup: How to Verify Your Domain and Read Every Dashboard

Postmaster Tools is the only place Google shows you how Gmail sees your mail: user-reported spam, reputation, authentication results and why messages were rejected. It is free, but it stays blank until you verify a domain, and many senders misread what it does show. This guide covers setup, then each dashboard in the order that matters.

What you need before you start

Postmaster Tools reports on mail sent to personal Gmail accounts (addresses ending in @gmail.com or @googlemail.com). It groups data by the domain that authenticates your mail, so you need mail that already passes SPF, DKIM or both. If you are not sure what your messages authenticate as, check the DKIM-Signature header's d= value and the Return-Path domain on a delivered message; reading email headers shows where to find them.

🛡️SPF, DKIM & DMARC CheckerRecursive SPF with the 10-lookup limit, DKIM keys and DMARC policyOpen the tool →

Step by step: add and verify a domain

1. Open Manage Domains in Postmaster Tools and click Add new domain.
2. Enter the authenticating domain. Google asks for the domain you use to authenticate outgoing mail with SPF, DKIM or both: the DKIM d= domain or the SPF Return-Path domain.
3. Publish the DNS record. Under More options choose Verify domain, copy the TXT or CNAME record into your DNS provider, return and click Verify.
4. Wait for the status. Google says verification can take up to 10 minutes to update. You may skip verification for now, but no data shows until the domain is verified.
5. Share access if needed. Under More options choose Manage users. Only verified domains can be shared, and the other person needs a Google or Google Workspace account.

Add each sending domain separately. A subdomain such as news.example.com that signs mail as itself needs its own entry, and the domain view only shows messages sent from the exact domain used for DKIM and SPF authentication.

The dashboards, in the order to read them

Dashboard	What it shows	Read it for
Spam rate	Share of messages delivered to engaged recipients' inbox and then marked as spam by the recipient	Your most important daily number
Compliance status	Compliant, Needs work or No data found for each sender requirement	Whether you meet Google's sender requirements
IP reputation	Quality rating of the IP addresses you send from	Problems tied to a shared or new IP
Domain reputation	Quality rating of the domains you send from	Problems that follow your brand across IPs
Feedback loop	Spam rate for campaigns carrying a feedback loop ID	Which campaign caused the spam reports
Authentication	Percent of mail passing SPF, DKIM and DMARC	Misconfigured senders
Encryption	Percent of authenticated mail sent over TLS, inbound and outbound	Transport security gaps
Delivery errors	Rejected or temporarily failed share of authenticated mail, with reasons	Throttling and blocks

Spam rate: the number to watch

Google's sender guidelines ask senders to keep the spam rate below 0.10% and to prevent it from ever reaching 0.30% or higher. For bulk senders, a user-reported rate above 0.30% makes you ineligible for mitigation, and you become eligible again after the rate stays below 0.30% for 7 consecutive days. Google defines a bulk sender as one sending close to 5,000 messages or more to personal Gmail accounts within 24 hours, and the status does not expire once reached.

The rate counts only messages delivered to the inbox, so the denominator is smaller than your send volume. Use the bounce and complaint rates guide for the arithmetic, and the calculator below to compare your own figures with the thresholds.

📊Email Metrics CalculatorDelivery, open, click, bounce and complaint rates with 95% confidence intervals and consistency warningsOpen the tool →

Reputation levels in plain terms

Level	Google's description	Practical meaning
High	History of very low spam rates and compliance with Gmail's sender guidelines	Mail is rarely marked as spam
Medium	History of legitimate email, but occasionally sends spam	Fair deliverability unless spam rises notably
Low	History of regularly sending a significant volume of spam	Mail likely to be marked as spam
Bad	History of regularly sending a high volume of spam	Mail almost always filtered or rejected

Reputation is a history, not a snapshot. One clean day does not lift a Low rating, and Google notes that the domain view includes only DKIM-authenticated data for some dashboards.

A worked example: reading a bad week

Suppose Postmaster Tools shows these values for a domain sending about 20,000 messages a day to Gmail:

Day	Spam rate	Domain reputation	Delivery errors
Mon	0.06%	High	0.2%
Wed	0.18%	High	0.4%
Fri	0.34%	Medium	3.1%

Friday's 0.34% is above the 0.30% line, so the first move is to find the campaign: open the feedback loop dashboard and match spike days to send dates. Rising delivery errors with a still-High reputation point to the early stage of a problem, not a settled one. Pause the segment that triggered reports, remove people who never engage, and watch for seven days below 0.30%. The 0.18% on Wednesday was already above the 0.10% target, which was the time to act.

Why your dashboard is empty or shows zero

• Domain not verified. No data appears until verification succeeds.
• Low volume. Days with a small number of messages can be partly or fully missing to protect user privacy.
• Wrong domain. The data is grouped by the exact DKIM or SPF domain, so a different signing domain will not show under the one you added.
• Not DKIM-signed. Some dashboards use DKIM-authenticated mail only.
• Spam rate missing or 0 after a bad period. Google notes this can happen after a historically high spam rate, when Gmail filters most mail to spam and few inbox messages are reported.
• Delay. Data is typically updated within 24 hours but can take longer; dates are in UTC.

Common mistakes

• Treating a 0% spam rate as proof of health. If most of your mail is going to spam, few inbox messages exist to be reported.
• Verifying the visible From domain only. The tool follows the authenticating domain, which your email service provider may set to its own domain until you configure your own.
• Ignoring Needs work in compliance. A requirement can show No data found simply because there was not enough eligible mail.
• Reading one day. Use the 7 or 30 day range before changing anything.

For the full list of requirements Postmaster Tools checks, see the Gmail and Yahoo bulk sender requirements checklist.

Frequently asked questions

Is Gmail Postmaster Tools free?

Yes. You sign in with a Google account, add your sending domain and verify it with a DNS record.

Why does Postmaster Tools show no data for my domain?

The most common reasons are that the domain is not verified, daily Gmail volume is too low (Google hides low-volume days for privacy), or you added a domain other than the one that signs your mail.

What spam rate should I aim for in Postmaster Tools?

Google asks senders to keep the user-reported spam rate below 0.10% and to prevent it from ever reaching 0.30% or higher.

Does Postmaster Tools show mail sent to Outlook or Yahoo?

No. It covers mail sent to personal Gmail accounts only.

How long does domain verification take?

Google says the status can take up to 10 minutes to update after you add the TXT or CNAME record.

References & further reading

1. Google — Postmaster Tools dashboards
2. Google Workspace Admin Help — Set up Postmaster Tools
3. Google Workspace Admin Help — Email sender guidelines FAQ