Gmail Postmaster Tools: Reading the Data Without the Headache
Gmail Postmaster Tools shows the data Gmail uses to decide whether your mail reaches the inbox or the spam folder. Here is how to read every chart without panicking.
Gmail receives roughly 30% of all consumer email worldwide. If your domain reputation drops in Gmail, your transactional pipeline drops with it. Postmaster Tools is the only first-party window into that reputation, and yet most senders open it once, see four colour-coded graphs that all say "Medium", and close the tab.
This article walks through every metric exposed in Postmaster Tools, how to read it in the context of your sending pattern, and what to do when one of them turns red. By the end you will know which graph predicts a deliverability incident two days before it happens.
Getting Set Up Correctly
Visit postmaster.google.com, add your domain, and verify it with a TXT or CNAME record. Use the same domain that appears in your DKIM d= alignment, not the address-level domain. If you authenticate as d=mg.example.com you must add mg.example.com to Postmaster.
⚠️ Warning: Postmaster Tools only shows data once you exceed roughly a few hundred emails per day from a given domain. Below that, the dashboard stays empty for privacy reasons.
The Six Dashboards That Matter
Postmaster shows six main views. Read them in this order:
1. Domain Reputation
This is the chart that matters most. Four buckets: Bad, Low, Medium, High. A reputation of High means almost all your mail reaches the inbox. Medium means it sometimes goes to spam, especially on first contact. Low means most goes to spam. Bad means almost everything goes to spam, including replies to existing threads.
The metric is per-domain, not per-IP. It updates daily. Movements between Medium and High are normal noise. Movements between Medium and Low are a warning. Any movement to Bad is an emergency.
2. IP Reputation
Same scale, but for each sending IP. Useful for shared infrastructure where one client can drag your IP down. If you use a dedicated IP, this should match your Domain Reputation. A large divergence (e.g. IP=High, Domain=Low) usually means a different sender is shipping mail with your domain in From — often a forwarder or an internal team you forgot about.
3. Spam Rate
The percentage of your mail that authenticated users marked as spam. Gmail considers anything below 0.1% acceptable, anything above 0.3% problematic, and anything above 0.5% disqualifying.
💡 Tip: Spam Rate is computed only against mail that landed in the inbox. Mail Gmail filtered to spam before users ever saw it does not count. This is why Spam Rate can look great even when delivery is terrible.
4. Feedback Loop
If you set up the FBL header (Feedback-ID: campaign-id:account-id:sender:identifier), Postmaster shows per-identifier spam rates. This is invaluable when you run multiple campaign types from one domain and want to know which type is dragging the average up.
Feedback-ID: receipts:acct_4f9:targetsmtp:purchase-v2That single header lets you split out "purchase confirmations" from "marketing weekly" in the same Postmaster account.
5. Authentication (SPF/DKIM/DMARC)
Three lines showing pass rates. Anything below 99% on SPF or DKIM means you have a misconfiguration somewhere — typically a forwarder, a third-party sender you forgot, or a misaligned subdomain. DMARC pass rate equals roughly min(SPF aligned, DKIM aligned).
6. Encryption (TLS) and IPv6
The percentage of mail sent over TLS to Gmail. Should be 100%. If you see anything less you have an outdated SMTP client somewhere. IPv6 has a stricter rule: Gmail rejects unauthenticated IPv6 mail outright, so if you send over IPv6 your SPF/DKIM had better be impeccable.
The Leading Indicator Most People Miss
If you only watch one chart, watch the Spam Rate against the Domain Reputation. A two-day lag exists between Spam Rate climbing and Domain Reputation downgrading. So a Spam Rate going from 0.08% to 0.18% on Monday usually means Domain Reputation will downgrade by Wednesday.
This gives you 48 hours of warning. Use it. Suppress questionable segments. Pause re-engagement campaigns. Investigate which template introduced the spike.
What "Medium" Reputation Actually Means
Many senders panic when reputation says "Medium". It is not a bad place to be. New domains start at Medium. Domains with seasonal traffic oscillate between Medium and High. Domains that send only transactional with verified consent and clean lists sit at High.
The problem is Medium-going-Low, not Medium itself. The difference is direction, not level.
Postmaster Does Not Tell You Why
Postmaster reports symptoms, not causes. If reputation drops you have to triangulate the cause yourself by cross-referencing:
- DMARC aggregate reports (what subdomains and IPs are sending in your name)
- Bounce log (sudden rise in 5.7.1 from Gmail)
- Suppression list growth rate (sudden jump = bad import)
- Marketing calendar (did a re-engagement go out?)
Configuring Feedback-ID Correctly
This is the single setup change that gives you the most leverage. Use four colon-separated fields:
Feedback-ID: <category>:<account-or-segment>:<sender>:<identifier>Example values from a SaaS:
Feedback-ID: invite:b2b-trial:acme-app:invite-2026-may
Feedback-ID: digest:weekly:acme-app:digest-active-users
Feedback-ID: reset:auth:acme-app:password-resetNow in Postmaster you will see one row per category and immediately spot that digest:weekly has a 0.4% spam rate while reset:auth has 0.001%. The fix is obvious: clean the digest list, leave auth alone.
What to Do When Reputation Drops
- Identify the affected stream via Feedback-ID.
- Pause that stream for 48 hours.
- Re-validate consent (when did the recipient sign up? Was it opt-in?).
- Remove anyone with zero opens or clicks in the last 90 days.
- Resume at 25% volume, double daily until baseline.
- Do not change templates during recovery — too many variables.
Closing Thought
Postmaster Tools is the cheapest feedback loop you have with Gmail. Check it once a week, set up Feedback-ID before you need it, and watch the Spam Rate as a leading indicator. If you would rather have Postmaster trends, FBL data and DMARC reports cross-correlated in one place, Target SMTP integrates all three and surfaces the cross-correlated signal — and the Send-Time Firewall can automatically throttle a Feedback-ID category once its spam rate crosses a threshold you define.