mailwel
Playbooks & Diagnostics · updated 2026-04-11

Google Postmaster Tool: Access Control

What Is Google Postmaster Tools?

Google Postmaster Tools (GPT) is a free dashboard provided by Google that shows senders how Gmail views their mail. It’s the only direct window into Gmail’s reputation model for your domain and IPs.

What it reveals:

  • Domain reputation (how Gmail scores your sending domain)
  • IP reputation (how Gmail scores your sending IPs)
  • Spam rate (percentage of your mail reported as spam by Gmail users)
  • Authentication results (SPF, DKIM, DMARC pass rates)
  • Encryption (TLS usage)
  • Delivery errors (SMTP error codes returned to your MTA)

What it doesn’t reveal:

  • Inbox vs. spam placement breakdown
  • Per-campaign metrics
  • Individual subscriber engagement
  • Content scoring or filtering reasons

Setting Up Google Postmaster Tools

Step 1: Access the Dashboard

Navigate to Google Postmaster Tools and sign in with a Google account.

Step 2: Add Your Domain

Click “Add Domain” and enter your sending domain (e.g., yourdomain.com).

Step 3: Verify Domain Ownership

Google requires DNS verification. You’ll be given a TXT record to add to your domain’s DNS:

Type:  TXT
Host:  @
Value: google-site-verification=xxxxxxxxxxxxxxxxxxxxx

Add this record through your DNS provider. Verification may take a few minutes to several hours depending on DNS propagation.

Step 4: Wait for Data

GPT only displays data when your domain sends a sufficient volume to Gmail addresses. Google’s threshold is approximately 100+ messages per day to Gmail users. Below this threshold, the dashboard shows “No data available.”

Important: Historical data is not retroactive. GPT starts collecting data from the day you verify the domain. There’s no way to see data from before verification.


Interpreting the Dashboard

Domain Reputation

The most important metric in GPT. Domain reputation is a categorical assessment:

Level Meaning Action
High Gmail trusts your domain. Mail flows to inbox normally. Maintain current practices
Medium Some trust issues. Mail may occasionally go to spam. Investigate — review complaint rates and engagement
Low Significant trust issues. High proportion of mail goes to spam. Urgent — reduce volume, focus on engaged subscribers
Bad Gmail considers your domain a spam source. Most mail goes to spam. Critical — stop non-essential sending immediately, begin recovery

How domain reputation is calculated: Gmail evaluates domain reputation based on:

  • User engagement with your messages (opens, reads, clicks, replies)
  • Spam complaint rate (users clicking “Report spam”)
  • Spam trap hits associated with your domain
  • Bounce rates and invalid address rates
  • Authentication compliance (SPF, DKIM, DMARC alignment)
  • Volume consistency (sudden spikes are penalized)

Key insight: Domain reputation is primarily driven by engagement and complaints, not by content. Fixing content rarely fixes a reputation problem. Fixing list quality and subscriber experience does.

IP Reputation

Similar categorical levels (High, Medium, Low, Bad) but for your sending IP addresses specifically.

When IP and domain reputation diverge:

  • Domain: High, IP: Low — You’re on a shared IP with other senders who have poor practices. Consider a dedicated IP or contact your ESP.
  • Domain: Low, IP: High — Your domain-specific signals (complaints, engagement) are poor even though your IP is clean. This is a list quality or content relevance problem.
  • Both Low/Bad — Comprehensive reputation failure. Full recovery plan needed.

If you use a dedicated IP, IP and domain reputation tend to move together. If you use a shared IP, they can diverge based on other senders’ behavior.

Spam Rate

The percentage of your emails that Gmail users reported as spam by clicking “Report Spam.”

Spam Rate Assessment Action
< 0.10% Good Maintain
0.10–0.30% Warning Investigate and reduce
> 0.30% Critical Immediate action needed

Context for the spam rate metric:

  • This counts only explicit user spam reports, not automated spam placement
  • The denominator is messages delivered to the inbox (not total sent)
  • A rising spam rate is a leading indicator of reputation decline
  • Google’s own threshold for concern is 0.10%, and critical is 0.30%

Why the threshold is so low: At 0.3%, if you send 100,000 emails, 300 people are reporting you as spam. Gmail interprets this as significant evidence that your mail is unwanted. From Google’s perspective, they’re protecting their users.

Authentication

GPT shows pass rates for SPF, DKIM, and DMARC:

  • SPF: Percentage of messages with a passing SPF check
  • DKIM: Percentage of messages with a valid DKIM signature
  • DMARC: Percentage of messages passing DMARC alignment

Target: 100% for all three. Any failures indicate misconfigured authentication or unauthorized senders using your domain.

Common authentication issues visible in GPT:

  • SPF < 100%: Some messages are sent from IPs not in your SPF record
  • DKIM < 100%: Some messages have invalid or missing DKIM signatures
  • DMARC < 100%: Some messages fail alignment (SPF domain or DKIM domain doesn’t match From header domain)

Encryption

Shows what percentage of inbound and outbound messages use TLS encryption.

Target: 100% outbound TLS. All modern ESPs and MTAs support TLS. If this is below 100%, your sending infrastructure has a TLS configuration issue.

Delivery Errors

Shows the SMTP error codes Gmail returned for rejected messages from your domain.

Common errors and their meaning:

  • Rate limit exceeded: You’re sending too fast. Implement throttling.
  • Suspected spam: Content or reputation triggered spam filters. Check domain reputation.
  • Bad or unsupported attachment: Blocked attachment type. Don’t send executables.
  • DMARC policy: Your DMARC p=reject policy is causing rejections for misaligned messages.
  • Low IP reputation: Your IP’s reputation is causing rejections. May need IP warmup or change.
  • Low domain reputation: Your domain’s reputation is causing rejections. Need reputation recovery.

Using GPT for Proactive Monitoring

Daily Review Routine

Spend 2–3 minutes each day on these checks:

  1. Spam rate: Is it stable, declining, or rising?
  2. Domain reputation: Any change from yesterday?
  3. Authentication: All at 100%?
  4. Delivery errors: Any new error categories?

Weekly Trend Analysis

Once per week, review the 7-day and 30-day trends:

  • Is domain reputation improving, stable, or declining?
  • What’s the spam rate trend over the past month?
  • Are there day-of-week patterns in spam rate?
  • How does the spam rate correlate with specific campaign types?

Alert Triggers

Set up workflow alerts for these GPT changes:

Trigger Severity Response Time
Domain reputation drops by one level Critical Same day
Spam rate exceeds 0.10% Warning Next 24 hours
Spam rate exceeds 0.30% Critical Immediately
Authentication drops below 100% Warning Same day
New delivery error category appears Warning Same day

Correlating GPT Data with Campaign Performance

GPT data lags by 24–48 hours. To correlate with specific campaigns:

  1. Note the send date of each campaign
  2. Check GPT two days later for any changes in spam rate, reputation, or delivery errors
  3. Track which campaigns correlate with metric changes
  4. Build a mapping between campaign types and their GPT impact

Over time, this mapping shows which types of campaigns help reputation and which hurt it. This data-driven approach to content planning is far more effective than guessing.


Common GPT Misinterpretations

“No data available” doesn’t mean a problem. It means your volume to Gmail is below the reporting threshold. This is common for small senders.

Domain reputation “Medium” isn’t necessarily bad. For senders who recently started sending, Medium is a normal starting point. It becomes concerning only if it drops from High.

Spam rate fluctuations are normal. A single day at 0.12% amid a consistent 0.05% trend isn’t a crisis. Look at the trend, not individual data points.

Authentication dips during DNS changes are expected. If you’re rotating DKIM keys or updating SPF, a brief authentication dip during propagation is normal. It should recover within 24–48 hours.

GPT doesn’t show everything. Gmail’s filtering model considers many more signals than what GPT displays. GPT shows the signals you can influence — reputation, authentication, and spam rate — but not the full picture of how Gmail classifies each message.

Google Postmaster Tools is the single most valuable free tool for email senders targeting Gmail. The senders who monitor it daily and respond quickly to changes consistently maintain better deliverability than those who check it only when problems are already visible in their inbox placement.