DomainCanary Start free

Guides

Google Postmaster Tools: set it up and read what Gmail shows you

Last updated 16 Nov 2026

Google Postmaster Tools is where Gmail shows you its own numbers for the mail you send: spam complaints, rejections and whether you meet its sender rules. You set it up with one DNS record. The dashboards you'll find there changed with version 2, and the reputation grades most guides still describe aren't in it.

Can you still see your domain reputation in Postmaster Tools? Not in version 2. Google says the Domain and IP Reputation dashboards will be retired, and the new interface doesn't have them.

Set up Postmaster Tools

  1. Sign in. Open Postmaster Tools with any Google account or Google Workspace account.
  2. Add the domain. On the Manage Domains page, click Add new domain. Enter the domain in your DKIM signature or your Return-Path, then click Create.
  3. Copy the verification record. Click More options beside the domain, then Verify domain. Copy the TXT or CNAME record it shows you.
  4. Publish it and verify. Add the record at your DNS host, go back to Postmaster Tools, and click Verify. Google says it usually verifies right away, and it can take up to 10 minutes.
  5. Add your sending subdomains. Once the main domain is verified, add each subdomain you send from, such as mail.example.com. Each one gets its own dashboards, and you don't need to verify them again.

Google's setup page has the same steps with screenshots. To let a colleague see the dashboards, click More options, then Manage users, and add their Google address. Tell them yourself, because Google doesn't send them a notice.

Add the domain your mail is signed with

Postmaster Tools files each message under the domain that authenticated it. Google asks for either the DKIM d= domain or the SPF Return-Path domain. Most of the dashboards count only DKIM-signed mail.

To find yours, open a message you sent to a Gmail address. Click the three dots, then Show original. The summary at the top shows a DKIM line with the signing domain. Add that domain.

If the DKIM line shows your email platform's domain instead of yours, your own domain's dashboards will stay empty. Set up DKIM with your own domain in that platform first. Our DKIM guide explains the selector and the record the platform will give you.

"Adding domain unsuccessful" and failed verification

Google's help pages don't explain the "Adding domain unsuccessful" message. Check the entry first. Type the bare domain, such as example.com, with no https://, no www. and no trailing slash. Add the main domain before any subdomain.

If a colleague already verified the domain, ask them to add you through Manage users. Google also lets each account verify the same domain with its own DNS record, so you can publish a second verification record if you'd rather have your own access.

When the domain adds but won't verify, either Postmaster Tools couldn't reach your DNS server or it didn't find the record. Wait a few minutes for the record to show up in DNS and check you pasted the whole string. If it still fails, start again with a new verification string.

Reputation grades aren't in version 2

The old interface graded your domain and each sending IP as High, Medium, Low or Bad. Version 2 dropped both grades. Google's deprecation page says Reputation data is not easily actionable for most senders. Google also says changes were slow to show up in the grade, and that reputation is only one of many factors in delivery.

When I last checked, on 30 Sep 2026, Google had postponed retiring the old interface and hadn't given a date. The Postmaster Tools API version 1 is being retired, and version 2 of the API has no reputation data either. Don't build monitoring around the grades, because Google plans to remove them.

In version 2, read these in place of the grade:

  • the Deliverability analysis, under Compliance status
  • the Delivery errors dashboard, whose reasons include "Sending domain has a low reputation" and "Sending IP has a low reputation"
  • the Spam rate dashboard

Compliance status checks you against Gmail's sender rules

The Compliance status dashboard checks your mail against Google's email sender guidelines. Every sender gets these rows:

  • SPF and DKIM authentication
  • DNS records
  • Message formatting
  • Encryption
  • User-reported spam rate

Bulk senders also get rows for DMARC authentication, one-click unsubscribe and honor unsubscribe. Google counts you as a bulk sender at about 5,000 messages or more to Gmail accounts in 24 hours.

StatusWhat it meansWhat to do
CompliantYour setup and your messages meet the requirement.Nothing.
Needs workYou don't meet the requirement. The status column says what to change.Fix it, then check again in 7 days.
No data foundGmail didn't receive enough of your mail to judge.Send more, or wait for more volume.

The status moves slowly. Google uses a rolling average over several days and says a fix can take up to 7 days to show. DNS rows reflect the records Gmail saw when your mail arrived, not what you've published since. To check your records as they stand today, run our SPF, DKIM and DMARC checker.

Compliance status covers the main domain only. If you added mail.example.com, its mail counts toward the status of example.com. Use the other dashboards to see a subdomain on its own.

If the "Honor unsubscribe" row shows Needs work, remove people within 48 hours of their request. Google counts a request as made even when a firewall or proxy in front of your server blocked it, so check those logs too.

Deliverability analysis gives one recommendation

Inside Compliance status, the Deliverability analysis shows a single recommendation about your domain's standing with Gmail. Google's dashboard page says you get one when:

  • you send too little email
  • your messages fail to deliver
  • you exceed the recommended spam threshold
  • recipients didn't open or interact with your email
  • recipients indicate they want more of your messages
  • you don't meet the sender guidelines

Read it first. It gives you Gmail's view of your mail and an action to take.

Spam rate: keep it under 0.3 percent

The spam rate is the share of your messages delivered to an inbox that the recipient then marked as spam. It counts DKIM-signed mail to personal Gmail addresses only. Google's sender guidelines say to keep it below 0.10% and never reach 0.30%.

A very low rate can be bad news. If Gmail already files most of your mail in spam, few messages reach an inbox to be reported, and the rate drops. A rate that falls from high to zero overnight usually means exactly that. Compare it with the Delivery errors dashboard and the Deliverability analysis.

After you fix the cause, give it time. Google says the rate can take up to 7 days to come back within its limits. Our guide to emails going to spam covers the list and content fixes.

Delivery errors list each reason Gmail refused your mail

This dashboard shows the percentage of your authenticated mail that Gmail rejected or deferred, with the reason for each.

ReasonWhat to do
Rate limit exceededStop sending, resume in a few minutes, and send at a steady rate.
Suspected spamGoogle says this usually follows a low domain or IP reputation. Bring complaints down first.
Email content is possibly spammyCheck the links and the body of the messages sent that day.
DMARC policy of the sender domainYour DMARC policy is p=reject and these messages failed it. Check your DMARC reports to see whether the source is yours.
Sending domain or IP has a low reputationCut complaints and stop mailing people who didn't ask. If it goes on while you meet the guidelines, use Google's bulk sender escalation form.
Domain or IP is in one or more public RBLsFind the listing and follow that list's removal process.
Bad or missing PTR recordThe sending IP has no reverse DNS name. Ask whoever runs that IP to add one.

If this dashboard shows more failures than your own logs, check for forwarding. When a recipient forwards your mail, the forwarding server gets the errors instead of you. Someone replaying old messages you signed has the same effect. For blocklists, our domain reputation guide covers each list's lookup.

Authentication and encryption dashboards

The Authentication dashboard shows the percentage of mail with your domain in the From line that passes SPF, DKIM and DMARC. Google says senders usually see 95 percent or more for DKIM and DMARC when both are set up correctly. SPF runs lower, mostly because of forwarding and third-party senders.

A low DMARC rate means some mail passed neither SPF nor DKIM for your domain. Our SPF, DKIM and DMARC overview shows how the three fit, and the DMARC policy guide covers what each policy does to that mail.

The Encryption dashboard shows the percentage of mail sent over TLS, inbound and outbound. If you send everything over TLS and it shows 0 percent, check your certificate and your TLS version.

Feedback loop needs a Feedback-ID header

The Feedback loop dashboard breaks the spam rate down by campaign. It only works if you add a Feedback-ID header to your messages, as Google's feedback loop page describes:

Feedback-ID: CampaignIDX:CustomerID2:MailTypeID3:SenderId

The last field is required and the others are optional. Sign the message with DKIM for your domain after the header is added. Campaigns with few complaints don't appear, because Google needs a minimum number of spam reports per ID.

Empty dashboards usually mean low volume

Google leaves out data on days when you send too little, to protect users' privacy. A small sender sees gaps, or no data at all. That's a limit of the tool.

Before you blame volume, rule these out:

  • the domain isn't verified yet
  • your mail is signed with your platform's domain, not yours
  • your recipients use Google Workspace, not personal Gmail

Postmaster Tools counts only mail to addresses ending in @gmail.com or @googlemail.com. It uses UTC, and data usually arrives within 24 hours.

What Postmaster Tools can't show you

It covers Gmail only, so you won't see Outlook, Yahoo or company mail servers there. You also get totals for your domain, with no list of the servers sending as you without your say-so.

DMARC aggregate reports show you those servers. Gmail, Yahoo and Microsoft all send them, and they list each source that sent as your domain with its SPF and DKIM results. On a paid plan, we email you the day a report shows a new sender failing DMARC, and one weekly digest covers all your domains. Your first domain is free.

Check all three records for your domain

SPF, DKIM and DMARC in one pass, read the way receivers read them.

Free · No signup · The result names what to change

Questions

Where did domain reputation go in Google Postmaster Tools?

The new version, Postmaster Tools v2, has no Domain Reputation or IP Reputation dashboard. Google says both will be retired along with the old interface. Read the Compliance status dashboard, its Deliverability analysis and the Delivery errors reasons instead.

Which domain do I add to Postmaster Tools?

The domain in your DKIM signature (the d= value), or the domain in your Return-Path that SPF checks. If your sending platform signs with its own domain, your dashboards stay empty until you set up DKIM with yours.

Why are my Postmaster Tools dashboards empty?

Google leaves out data on days when you send too little mail to personal Gmail accounts, to protect users' privacy. The dashboards also stay blank until the domain is verified, and data can take more than 24 hours to arrive.

What spam rate does Gmail want to see?

Below 0.3 percent, and ideally below 0.1 percent. Google's sender guidelines say to keep the rate in Postmaster Tools under 0.10% and never reach 0.30%.

DomainCanary is a DMARC enforcement service that protects your domain from email spoofing without blocking your own mail.