
Google Postmaster Tools is a free dashboard from Google that shows how Gmail treats the email your domain sends: your spam complaint rate, whether your mail passes SPF, DKIM and DMARC, whether it is encrypted, and why messages were rejected. It is the only place to see Gmail's own numbers for your domain. Setup takes about 10 minutes and one DNS record.
The tool changed in 2025 and 2026. The domain and IP reputation scores that most guides still describe are gone. This guide covers the current version, as of November 15, 2026.
What is Google Postmaster Tools, and who needs it?
Google Postmaster Tools is Gmail's reporting service for senders. Anyone who sends email to Gmail addresses from their own domain can use it, and anyone sending marketing, cold outreach or product email at volume should.
Google's email sender guidelines tell senders to keep the spam rate "reported in Postmaster Tools" below 0.30%. That makes the dashboard the reference for a rule you are already being held to.
There is one catch. Postmaster Tools only shows data once your domain sends enough mail to Gmail users each day. Google does not publish the threshold. Low-volume domains often see empty charts, and a chart can have gaps on quiet days.
How do you set it up?
Set it up by adding your domain and proving you own it with a DNS record. You need access to the domain's DNS and a Google account.
- Go to postmaster.google.com and sign in.
- Click the add button and enter the domain you send from.
- Google shows a TXT record. Copy it.
- Add the TXT record at your DNS host, on the domain itself.
- Return to Postmaster Tools and click Verify.
The record looks like this:
example.com. TXT "google-site-verification=rXOxyZounnZasA8Z7oaD3c14JdjS9aKSWvsR1EbUSIQ"
Three details save time:
- Add the domain in your From line. If you send as
news.example.com, add that subdomain. Once the parent domain is verified, its subdomains can be added without a new record. - Add the DKIM signing domain too if it differs from the From domain. Gmail groups some data by the
d=domain in the signature. - Leave the TXT record in place. Google rechecks it, and removing it removes your access.
Data usually appears within a day or two of verification, and only for days with enough volume. You can share access with a colleague or an agency from the domain's menu without sharing your Google login.
What do the dashboards show in the current version?
The current version, called v2, shows compliance status, spam rate, authentication, encryption, delivery errors and feedback loop data. It no longer shows domain reputation or IP reputation.
| Dashboard | What it shows | What good looks like |
|---|---|---|
| Compliance status | Pass or fail against each of Google's sender requirements | Every row compliant |
| Spam rate | Share of your inboxed mail that users reported as spam | Below 0.10% |
| Authentication | Share of mail passing SPF, DKIM and DMARC | 100%, or close to it |
| Encryption | Share of mail sent over TLS | 100% |
| Delivery errors | Share of mail rejected or temporarily failed, with the reason | Under 1% |
| Feedback loop | Complaints grouped by campaign identifier | No single campaign standing out |
The compliance status dashboard is the fastest read. It lists the requirements from Google's sender guidelines, such as SPF and DKIM authentication, DMARC, alignment, TLS, one-click unsubscribe and spam rate, and marks each one as met or not.
What happened to domain reputation and IP reputation?
Google removed the domain reputation and IP reputation dashboards. The scores of Bad, Low, Medium and High were retired from September 30, 2025, and the old v1 interface stopped being available in August 2026, according to tracking by Inbox Monster.
This matters because most advice still says "check your domain reputation in Postmaster Tools". That score no longer exists. Gmail still keeps a reputation for your domain, and it still decides placement. You can no longer read it as one grade.
What replaces it is the set of inputs that reputation is built from:
| The old score told you | Read this now |
|---|---|
| Reputation is falling | Spam rate rising above 0.10% |
| Gmail distrusts your mail | Compliance status showing a failed requirement |
| An IP is in trouble | Delivery errors naming a rate limit or a bad IP |
| A campaign did damage | Feedback loop complaints for that campaign |
A tool that claims to show your "Gmail domain reputation score" today is estimating it. Only the dashboards above come from Google.
How do you read the spam rate?
The spam rate is the number of messages users marked as spam, divided by the number delivered to the inbox for active users. Messages that went straight to spam are not counted, because nobody can report them.
That definition has a consequence people miss. A falling spam rate can be bad news: if Gmail starts filing your mail as spam, fewer people see it, fewer report it, and the rate drops while your results collapse. We check it next to open and reply rates for that reason.
Google gives two numbers in its guidelines:
| Spam rate | What it means |
|---|---|
| Below 0.10% | The target. 1 complaint per 1,000 inboxed messages |
| 0.10% to 0.29% | Above target. Placement starts to suffer |
| 0.30% or higher | Out of compliance. Google says to avoid ever reaching it |
Google also states that senders above 0.30% are not eligible for mitigation, meaning its support will not help you recover until the rate is back down.
One bad day is not a verdict. Look at the trend over 7 to 14 days, and match spikes to what you sent that day.
Which delivery errors matter?
The delivery errors that matter are the ones that repeat. The dashboard splits failures into rejected, which is permanent, and temporary failures, and gives a reason for each.
| Reason shown | Usual cause | What to do |
|---|---|---|
| Rate limit exceeded | Volume rose faster than your reputation supports | Slow down and spread sends over more hours |
| Suspected spam | Content or reputation tripped the filter | Check the spam rate and recent list sources |
| Bad or missing PTR record | The sending IP has no reverse DNS | Ask your host to set a PTR record |
| DMARC policy of the sender domain | Your own DMARC policy rejected unaligned mail | Fix alignment for the failing service |
| Low reputation of the sending IP or domain | Accumulated poor signals | Reduce volume and send to engaged recipients first |
The matching bounce in your own logs gives the detail. A rate limit from Gmail reads like this:
421 4.7.28 Gmail has detected an unusual rate of unsolicited mail originating from your IP address. To protect our users from spam, mail sent from your IP address has been temporarily rate limited.
A 4xx code is temporary and the sending server will retry. A 5xx code is permanent.
What should you check, and how often?
Check Postmaster Tools weekly in normal times and daily during a warm-up, a migration or a deliverability problem. The routine takes 5 minutes.
- Open compliance status. Any failed row is the first job.
- Read the spam rate for the last 14 days. Note any day above 0.10%.
- Confirm authentication is at or near 100% for SPF, DKIM and DMARC.
- Scan delivery errors for a reason that repeats.
- Write down the date and the numbers, so you have a baseline when something changes.
When we take on a recovery, the first thing we ask for is Postmaster Tools access, because it turns a guess into a measurement. A spam rate of 0.4% and a failed DMARC row call for two different repairs, and the dashboard shows which one you have.
Postmaster Tools covers Gmail only. For Outlook.com, Microsoft offers Smart Network Data Services (SNDS), which reports by sending IP. Yahoo offers a complaint feedback loop through its Sender Hub.
What can Postmaster Tools not tell you?
It cannot tell you your inbox placement rate, and it cannot see anything outside Gmail. It also says nothing about why users complained, only that they did.
It reads authentication results from mail that already arrived. To see what your domain publishes before you send, use the SPF record checker, the DMARC checker or the free email deliverability test, which reads every record at once.
If compliance status shows failures you cannot clear, or the spam rate will not come down, see what our email deliverability audit covers. Results from that kind of work are on our case studies page.
Drafted with AI assistance from our own records and client work, then reviewed and approved by Kunal Arora. See our editorial policy.