Google Postmaster Tools: Setup Guide and How to Read the Data
Google Postmaster Tools gives you direct insight into how Gmail sees your email. Learn how to set it up, what each metric means, and how to act on the data.
What is Google Postmaster Tools?
Google Postmaster Tools is a free service from Google that shows you data about your email sending as seen from Gmail's perspective. It provides metrics on spam rates, domain reputation, IP reputation, authentication, and delivery errors for mail sent to Gmail addresses.
This is one of the most valuable free tools for email senders because it shows you exactly what Gmail thinks of your email — the same data used to decide inbox vs. spam placement.
How to set up Postmaster Tools
1. Go to postmaster.google.com and sign in with a Google account 2. Click 'Add Domain' and enter your sending domain 3. Verify ownership via DNS: add a TXT record that Google provides to your domain's DNS 4. Once verified, data appears within 24-72 hours (only if you're sending significant volume to Gmail)
Note: Data only appears for days when you sent at least a few hundred emails to Gmail addresses. Low-volume senders may see 'Insufficient data'.
Key metrics and what they mean
Spam Rate: The percentage of Gmail users who marked your email as spam. Under 0.10% is good; 0.30%+ triggers filtering. This is the single most important metric.
Domain Reputation: A 4-level rating (Bad/Low/Medium/High) representing Gmail's overall trust in your domain. High = inbox. Bad = spam folder or blocking.
IP Reputation: Same 4-level rating for your sending IP.
Authentication: Percentage of your messages passing SPF, DKIM, and DMARC. Should be close to 100%.
Delivery Errors: Volume of bounces and rejections from Gmail, broken down by error type.
- < 0.10%
- Spam rate target
- 0.30%
- Spam rate blocking threshold
- 4
- Domain reputation levels
- 100%
- Authentication target
Gmail begins filtering above this threshold
Sustained above this causes outright delivery blocking
Bad / Low / Medium / High — only High guarantees inbox
Any authentication failures need immediate investigation
- Spam Rate
- The percentage of Gmail users who clicked 'Report spam' on your messages. Postmaster Tools shows this on a rolling basis. The most actionable deliverability metric — spikes indicate content or targeting problems.
- Domain Reputation
- Gmail's 4-level trust rating for your sending domain: High (inbox), Medium (some filtering), Low (mostly spam), Bad (blocked). Based on historical engagement and spam signals.
- IP Reputation
- Same 4-level rating for your sending IP address. Less important than domain reputation for Gmail, but still factored in. Shared IPs can be dragged down by other senders.
- Spam Feedback Loop
- Gmail's mechanism for reporting spam complaints back to senders who have verified their domain in Postmaster Tools. Only available through Postmaster Tools — not via standard FBL programs.
- Delivery Errors
- Gmail's breakdown of why some of your emails bounced or were rejected — invalid recipients, rate limits, reputation blocks, etc. Useful for diagnosing specific delivery problems.
Acting on Postmaster Tools data
High spam rate: Look at which campaigns trigger spikes. Check subject lines for misleading content, unsubscribe ease, and list quality. If the spike correlates with a specific segment, suppress it.
Low domain reputation: This requires sustained improvement. Stop all campaigns temporarily, clean your list aggressively, and restart with smaller sends to highly engaged segments only.
Authentication below 100%: Investigate which of your sending services isn't properly signing email. Check SPF includes and DKIM selectors for all ESPs you use.
Delivery errors: 'Invalid recipient' errors mean high invalid address rates — clean your list. 'Exceed rate limit' means you're sending too fast — implement proper throttling.
Check your domain's email health
Run a free scan against 60 blacklists. Validate SPF, DKIM, DMARC, and MX records in seconds.
Related free tools