Google Postmaster Tools is a free Google dashboard showing how Gmail sees the email your domain sends to personal Gmail accounts. To use it, sign in at postmaster.google.com, add your domain, verify it with a DNS record, then check the Compliance status and Spam rate dashboards regularly. Aim to keep your user-reported spam rate below 0.1%, and never reach 0.3%.
This guide covers setting it up, what each dashboard means in the current version, what changed with reputation data, and what to do when the numbers look bad.
Key takeaways
- Google Postmaster Tools is a free dashboard showing how Gmail sees mail your domain sends to personal Gmail accounts.
- Set it up at postmaster.google.com by adding your domain and verifying it with a TXT or CNAME record.
- Keep your user-reported spam rate below 0.1% and never let it reach 0.3%, which is 3 complaints per 1,000 inbox messages.
- Fixes can take up to 7 days to show on the Compliance status dashboard, so recheck a week later rather than daily.
What is Google Postmaster Tools?
Postmaster Tools reports data about mail from your domain to personal Gmail addresses: user-reported spam rate, authentication results, encryption, delivery errors and whether you meet Gmail's sender requirements. It doesn't show individual messages or recipients, and it doesn't cover mail to Google Workspace business accounts.
It matters because Gmail's sender guidelines measure the spam rate "reported in Postmaster Tools". If you send marketing email to Gmail users, it's the closest thing you have to an official scorecard.
How do I set up Google Postmaster Tools?
- Sign in at postmaster.google.com with a Google account.
- Add your domain. Use the domain in your From address, or the domain your mail is DKIM signed with. Google's compliance data is assessed on primary domains, with subdomain data feeding into it.
- Verify ownership. Google shows a TXT or CNAME record. Add it at your DNS provider and click Verify. Google says verification is usually immediate but can take up to 10 minutes to show.
- Wait for data. Dashboards typically update within 24 hours. If you send low volumes, some dashboards may stay empty, because Google withholds data when daily volume is too low to protect user privacy.
Your sending also needs to be properly authenticated for Postmaster Tools to attribute it to you. Check your records first with MakeItFlow's free DKIM checker and DMARC checker.
Which version of Postmaster Tools is current?
Google launched a new version of Postmaster Tools (v2) in 2024 and planned to retire the legacy interface. It has since postponed that deprecation after sender feedback and hasn't given a new date, but says the old version will eventually go and users will be redirected to v2.
The most important change: Google says the Domain Reputation and IP Reputation dashboards are being retired, and will be replaced by a new reputation dashboard it describes as more actionable. You may still see the older reputation views in places while the transition continues, but don't build your monitoring around the old High/Medium/Low/Bad ratings.
There is also a v2 API (currently documented as v2beta) that includes compliance status data, for teams that want to pull figures into their own reporting. The v1 API is being retired.
What do the Postmaster Tools dashboards show?
You can view data for the last 7, 30, 60, 90 or 120 days, with times in UTC.
| Dashboard | What it shows | What to look for |
|---|---|---|
| Compliance status | Whether you meet Gmail's sender requirements | Every row "Compliant" |
| Spam rate | % of messages users marked as spam after reaching the inbox | Below 0.1%, never 0.3% |
| Feedback loop | Spam rates per campaign, using your Feedback-ID header | Which campaign or stream causes complaints |
| Authentication | % of mail passing SPF, DKIM and DMARC | Close to 100% |
| Encryption | % of mail sent over TLS | 100% |
| Delivery errors | % of authenticated mail rejected or temporarily failed, with reasons | Spikes, and the error type |
How do I read the Compliance status dashboard?
Compliance status checks your sending against Gmail's sender requirements. Each requirement shows Compliant, Needs work or No data found.
- For all senders: SPF and DKIM, DNS records (forward and reverse DNS), message formatting, encryption and user-reported spam rate.
- For bulk senders only (around 5,000 or more messages to Gmail accounts in 24 hours): DMARC, one-click unsubscribe and honouring unsubscribe requests within 48 hours.
The data is a rolling average, so Google says a fix can take up to 7 days to show. If a row says "Needs work", fix the underlying issue and check again a week later rather than daily. Our guide to Gmail, Yahoo and Microsoft sender requirements explains each rule.
What is a good spam rate in Postmaster Tools?
Google's guidance is to keep the spam rate below 0.1% and avoid ever reaching 0.3%. Google's FAQ adds that bulk senders above 0.3% become ineligible for mitigation (help from Google with delivery problems) until their rate stays below 0.3% for 7 consecutive days.
To put that in context, 0.3% is 3 complaints per 1,000 messages delivered to the inbox. The rate is calculated from mail that reached the inbox, so a campaign that mostly went to spam can show a misleadingly low number.
If your spam rate rises:
- Use the Feedback loop dashboard (after adding a
Feedback-IDheader via your email platform) to find which campaign or mail type is responsible. - Stop mailing unengaged contacts and anyone who didn't clearly opt in.
- Make unsubscribing easy. One-click unsubscribe and a visible link reduce "report spam" clicks.
- Reduce frequency if you've recently started sending more often.
What should I do about delivery errors?
The Delivery errors dashboard shows the share of authenticated mail Gmail rejected or deferred and the reason category, such as rate limiting, suspected spam or authentication problems. Match spikes against your sending logs and bounce codes. Our guide to why emails go to spam covers the common causes, and Gmail's bounce codes (such as 421 4.7.28 for unusual volume or 550 5.7.26 for authentication) point to the fix.
MakeItFlow doesn't connect to Postmaster Tools, but it complements it: run a free website audit to check the DNS side Gmail relies on (MX, SPF, DKIM, DMARC, MTA-STS, TLS-RPT and BIMI) in one scan.
Frequently asked questions
Why is my Postmaster Tools dashboard empty?
Most often because your daily volume to personal Gmail accounts is too low for Google to show data. It can also mean you verified a different domain from the one your mail is authenticated with, or that data simply hasn't updated yet, which can take 24 hours or more.
Does Postmaster Tools show data for Google Workspace recipients?
No. Postmaster Tools reports on mail sent to personal Gmail accounts. Mail to businesses using Google Workspace isn't included.
Can I add my agency's clients' domains?
Yes, if each client adds the verification record to their DNS. Each domain is verified separately, so agencies typically ask clients to add the record during onboarding.
Is there an equivalent for Outlook.com and Yahoo?
Microsoft offers Smart Network Data Services (SNDS) and the Junk Mail Reporting Program for senders with their own IPs, and Yahoo offers a Complaint Feedback Loop through its Sender Hub. Neither is a direct copy, but both help you spot complaints.
Do I need Postmaster Tools if I only send staff email?
It's less useful, as low volumes may not produce data. It costs nothing to set up, though, and it starts collecting once your volume grows, for example when you launch a newsletter.
What to do next
Verify your main sending domain in Postmaster Tools today, then add a monthly reminder to check Compliance status and Spam rate. If a row shows "Needs work", fix it, wait a week and recheck. Keep an eye on Google's announcements about the new reputation dashboard as the legacy interface is retired.
Related reading
- Email Bounce Codes Explained: 550, 5.7.x and 4xx Soft Bounces: Email bounce codes explained: what 550, 5.1.1, 5.7.x and 4xx soft bounces mean, which are your fault, and how to fix each one. With Gmail and Microsoft codes.
- Why Do My Emails Go to the Gmail Promotions Tab?: Emails landing in Gmail's Promotions tab? Learn why Gmail sorts mail this way, why it isn't spam, and practical steps to reach Primary more often.
Sources
- Google Workspace Admin Help: Get started with Postmaster Tools
- Google Workspace Admin Help: Postmaster Tools dashboards
- Gmail Help: Learn about the deprecation of the old Postmaster Tools interface
- Google Workspace Admin Help: Email sender guidelines
- Google Workspace Admin Help: Email sender guidelines FAQ
Written by the MakeItFlow team
We build the website audit these guides are based on. Every fact is checked against the primary sources listed above and this guide was last reviewed on 25 October 2026 . How we research and check
Check your own site in 30 seconds
Run a free audit covering speed, SEO, DNS, email authentication and security headers — and get a prioritised fix list.
