How to Set Up Google Postmaster Tools (Step by Step)
The short answer
Sign in to Postmaster Tools with a Google account, click Add domain, and enter the domain that signs your outgoing mail with SPF or DKIM. Add the TXT or CNAME record it gives you to your DNS to verify ownership. Data appears once you send enough mail to personal Gmail addresses.
How to set up Google Postmaster Tools: add and verify your sending domain, add subdomains, grant team access, and fix the common no-data problem.
On this page
Google Postmaster Tools is a free dashboard that shows how Gmail treats the mail your domain sends: your spam-complaint rate, domain and IP reputation, authentication results, and delivery errors. To set up Google Postmaster Tools you do two things — add your sending domain, then prove you own it by adding one DNS record. That is the whole setup.
One caveat up front, because it decides whether the tool is useful to you: Postmaster Tools only reports on mail sent to personal Gmail addresses — the ones ending in @gmail.com or @googlemail.com. It shows nothing about mail delivered to Google Workspace inboxes on custom domains. If your recipients are all on Workspace, the dashboards stay empty no matter how clean your setup is (verified against Google's setup documentation, August 2026).
Before you start#
The setup itself takes about five minutes. Gathering the prerequisites is the part people skip, so check these first.
If you have never touched your DNS before, the verification record goes in the same place as your SPF and DKIM entries, and DNS changes can take a little time to propagate before Google can read them.
- A Google account to sign in. A personal Google account or a Google Workspace account both work here — this is only about who logs in, not who gets measured.
- Your sending domain — specifically the domain that authenticates your outgoing mail, which is the domain in your DKIM signature (the d= value) or your SPF record. It may be a subdomain of your visible From address.
- SPF, DKIM, or both already in place. Postmaster Tools attaches data to the domain that signs your mail, so authentication has to exist first.
- Access to your DNS. You will add one TXT or CNAME record at your domain provider — Cloudflare, your registrar, or your DNS host.
- Real volume to Gmail. The dashboards populate only once you send enough mail to @gmail.com addresses on a given day.
Workspace login is fine — Workspace recipients are not measured
How to set up Google Postmaster Tools, step by step#
- 1
Sign in with a Google account
Go to postmaster.google.com and sign in. A personal Google account or a Google Workspace account both work for signing in — this is separate from which recipients get measured.
- 2
Add your sending domain
Click Add domain and enter the domain you use to authenticate outgoing mail with SPF or DKIM — the domain in your DKIM signature (the d= value) or SPF record. This can be a subdomain of your From address, so add the exact domain that signs the mail.
- 3
Verify that you own the domain
Postmaster Tools shows you a TXT record (or a CNAME). Copy it into your domain's DNS at your provider, then return and click Verify. Google usually verifies within seconds, and up to 10 minutes. Verification is technically optional, but without it you will see no data.
- 4
Add subdomains separately, if you use them
A verified primary domain does not automatically show subdomain dashboards. If you send from subdomains such as mail.example.com, add and verify each one the same way to get its own dashboard.
- 5
Grant access to your team
On a verified domain, open its sharing settings and add the Google email address of each person who needs access. They will need a Google account to sign in, and everyone you add can view that domain's dashboards.
- 6
Wait for data to appear
Data is not real-time. Postmaster Tools populates once your domain sends enough mail to personal Gmail addresses on a given day; low-volume days can stay blank to protect recipient privacy. Give it a few days of normal sending.
What Postmaster Tools shows in each situation#
The same setup behaves differently depending on where your mail lands and how much you send. Verification unlocks the dashboards, but your volume and your recipients' network decide how much you actually see. This is what to expect once your domain is verified.
| Your situation | What the dashboards show | What to do |
|---|---|---|
| You send to personal Gmail (@gmail.com) | Full data — reputation, spam rate, authentication, delivery errors | Add and verify your sending domain |
| You send only to Google Workspace inboxes | No delivery or spam data — Workspace recipients are out of scope | Use it only if you also send to @gmail.com addresses |
| You send from several subdomains | Each subdomain needs its own entry to get its own dashboard | Add each subdomain the same way as the primary domain |
| You send low daily volume to Gmail | Charts may stay empty; data is withheld to protect recipient privacy | Increase volume — Google does not publish the exact threshold |
| You also send to Outlook.com or Yahoo | Not covered — those are separate networks | Add Microsoft SNDS and Yahoo's Sender Hub separately |
Why Postmaster Tools shows no data (and how to fix it)#
The most common question after setup is: I added my domain and there is still nothing. Almost always it is one of a short list of causes, and none of them is a bug.
Two causes account for most empty dashboards. The first is verification — a domain sits in your list looking added, but the DNS record was never saved, or was saved with a typo, so Google never confirmed ownership. The second is volume: even a verified domain shows nothing until it clears Google's privacy floor, and Google deliberately does not publish where that floor sits. Work through the rest in order before assuming something is broken.
| Cause | Why it happens | Fix |
|---|---|---|
| Domain added but never verified | Unverified domains show nothing | Add the TXT or CNAME record, then click Verify |
| You verified it today | Data is delayed, not real-time | Wait a few days of normal sending |
| Low volume to Gmail | Google withholds data below a privacy floor it does not publish | Grow volume, or accept sparse charts on a small domain |
| Wrong domain added | Data attaches to the DKIM or SPF domain, not always the From domain | Add the exact domain in your DKIM d= value or SPF record |
| You send only to Workspace inboxes | Only personal Gmail delivery is measured | Nothing to fix — it is outside what the tool reports |
| Authentication changed recently | Reputation rebuilds against the new signing domain | Give the current signing domain time to accumulate history |
A faster way — and the honest limit#
There is no shortcut for the setup above: you add one DNS record, and Google does the monitoring from then on. Postmaster Tools watches the mail you send, and a mail client cannot do that job. AI Emaily does not either — we do not monitor sending reputation, run DMARC reports, or test deliverability. For that, Postmaster Tools, Microsoft SNDS, and Yahoo's Sender Hub are the right stack.
Where AI Emaily fits is the other side of the same problem: the mail that reaches your own inbox. Our AI spam and phishing protection triages what lands, and we never train on your mail. So — sending reputation goes to Postmaster Tools; a clean, triaged inbox is the job we do. We build AI Emaily.
Frequently asked
See it in AI Emaily
Written by
Nafiul HasanNafiul Hasan is an entrepreneur and AI automation system builder with 10+ years of experience turning messy, manual workflows into reliable automated systems. He designs and ships AI enterprise solutions end-to-end — the agent logic, the data plumbing, and the product people actually use — and founded AI Emaily to give busy professionals their attention back. He writes here from the builder's seat: what works, what breaks, and how to put AI to work without giving up control.