KoltrixGoogle Postmaster Tools: the dashboards that matter
Postmaster Tools is the only first-party view into how Gmail sees your domain. Set it up, read the spam rate and compliance views, and know its blind spots.
On this page(7 sections)
- Setting it up
- The volume caveat
- The views that matter most
- Spam rate
- Compliance status
- Authentication
- Encryption
- Delivery errors
- Reputation views
- Using it for diagnosis
- Scenario: open rates dropped at Gmail
- Scenario: a new provider or vendor went live
- Scenario: an IP warm-up
- Feedback-ID for larger senders
- Limits to keep in mind
- A weekly routine
- Key takeaways
Gmail does not send per-message complaint reports to ordinary senders, and it does not tell you why a message landed in spam. Google Postmaster Tools is the closest thing to a first-party view of how Gmail sees your domain.
It is free, takes ten minutes to set up, and is the only place to see the spam rate Gmail measures against its sender requirements.
Setting it up
- Sign in at Postmaster Tools with a Google account.
- Add your domain. Use the domain that appears in your From addresses, or the DKIM signing domain; Postmaster data is attributed to authenticated domains.
- Verify ownership by publishing the TXT record Google gives you:
example.com. TXT "google-site-verification=abc123..."- Optionally add subdomains you send from, such as
news.example.com, and grant access to colleagues.
A verification TXT record is separate from SPF and does not affect it. Keep it published; removing it can cost you access.
The volume caveat
Postmaster Tools shows data only when your daily volume to personal Gmail accounts is substantial enough for Google to report on it. Low-volume senders may see empty dashboards or data only on busy days. That is not an error; it is a privacy and statistical threshold.
The views that matter most
Google has revised the interface over the years, including a newer version that added a compliance status view. Exact names may differ from what you see, but the core data has stayed consistent.
Spam rate
The user-reported spam rate is the share of inbox-delivered messages that Gmail users marked as spam on a given day. This is the number Gmail's sender requirements refer to: keep it below 0.3%, and ideally below 0.1%.
How to read it:
- Look at trends, not single days. A one-day spike after a campaign is a prompt to investigate that campaign; a gradual climb is a list quality problem.
- Remember the denominator. Messages already filtered to spam are not included, because users cannot report them. A falling spam rate combined with falling engagement can mean more mail is being filtered, not that recipients are happier.
- Correlate with your send calendar. Annotate big campaigns so spikes are easy to explain.
Compliance status
The compliance view summarizes whether your domain meets Gmail's sender requirements: authentication with SPF and DKIM, a DMARC record, alignment, TLS, reverse DNS, one-click unsubscribe for applicable mail and spam rate. Each item shows whether Google observes your traffic as compliant.
This is the fastest way to confirm a fix. After enabling aligned DKIM for a vendor, for example, you can watch the relevant item move to compliant over the following days.
Authentication
Shows the percentage of your traffic that passed SPF, DKIM and DMARC. Healthy domains are close to 100% for DKIM and DMARC. Dips usually mean a new or misconfigured sending source; cross-check with your DMARC aggregate reports to find which one.
Encryption
Shows the share of inbound traffic from you that used TLS. Anything short of nearly all is worth investigating, since Gmail requires TLS for all senders.
Delivery errors
Shows the share of your traffic that Gmail rejected or temporarily failed, with categories such as rate limiting or authentication problems. A rise here often appears before you notice it in your own bounce logs, especially since Gmail stepped up enforcement in November 2025.
Reputation views
Earlier versions of Postmaster Tools displayed domain and IP reputation on a scale from "bad" to "high." Those views were useful but coarse, and Google has changed how reputation is presented over time. If your interface shows them, treat them as direction indicators and rely on spam rate, delivery errors and compliance status for decisions.
Using it for diagnosis
Scenario: open rates dropped at Gmail
Check the spam rate and delivery errors for the same days. A spam rate that rose before the drop suggests recipients started complaining, and Gmail started filtering. Delivery errors rising suggests rejections or throttling. If both look normal, check authentication; a broken DKIM setup on one stream can push its mail to spam without generating many errors.
Scenario: a new provider or vendor went live
Watch authentication and compliance status for a week. If DMARC pass rates dip, the new sender is probably not aligned.
Scenario: an IP warm-up
Watch delivery errors for rate-limit categories and the spam rate daily. Slow down if either moves the wrong way.
Feedback-ID for larger senders
Gmail offers a Feedback Loop for senders who add a Feedback-ID header to their messages. The header carries identifiers you choose, such as campaign, customer and mail type, and Postmaster Tools then reports spam rates aggregated by those identifiers. It does not identify individual recipients. It is aimed at email service providers and high-volume senders that need to know which campaign or customer drives complaints:
Feedback-ID: campaign-2026-09:newsletter:acct-42:exampleInclude the header in your DKIM signature so it cannot be altered in transit, and check Google's current Feedback Loop documentation for its format rules. Identifiers should not be unique per message, or the aggregation becomes useless.
Limits to keep in mind
- Gmail only. Postmaster Tools says nothing about Outlook.com, Yahoo or other providers. Use their own tools and feedback loops.
- Delayed and aggregated. Data typically appears a day or more later and is never per message.
- Personal accounts. Data reflects mail to personal Gmail users, not necessarily Google Workspace recipients.
- No reasons for filtering. It shows outcomes and signals, not explanations for individual placement decisions.
A weekly routine
- Check the spam rate for each domain, and flag anything above 0.1%.
- Check compliance status and investigate any item that is not compliant.
- Check authentication pass rates against your DMARC reports.
- Check delivery errors for new categories or rising rates.
- Note campaigns or infrastructure changes alongside the data.
Key takeaways
- Postmaster Tools is Gmail's only first-party view of your domain, and it is where the 0.3% spam rate threshold is measured.
- Verify each sending domain with a TXT record; data appears once volume is high enough.
- Spam rate, compliance status, authentication and delivery errors are the views that drive decisions.
- The spam rate excludes mail already filtered to spam, so read it alongside engagement.
- Larger senders can use the Feedback-ID header to see complaint rates by campaign.
Start with Koltrix
Your domain, one inbox, and an API that sends.
A team inbox where AI sorts and drafts (nothing is sent without your click), plus the transactional API and SMTP relay your product sends with. 7 days free, no card.
