How to Set Up Postmaster Tools (2026 Guide for WordPress Users)

Google Postmaster Tools is the only free way to see what Gmail thinks of your WordPress emails. It covers spam rates, authentication pass rates, delivery errors, and whether you comply with Gmail’s bulk sender rules.

In late 2025 Google redesigned the platform. The Domain Reputation and IP Reputation dashboards were retired and a new Compliance Status dashboard took their place. If you want to know how to set up and use Google Postmaster Tools V2, this is the guide you’re looking for!

We’ll cover how to set up Postmaster Tools, how to understand the v2 dashboards, and what to do if you flag a problem.

Quick Summary

Postmaster Tools is a free service from Google that shows you how Gmail sees your email. To set it up, sign in at postmaster.google.com, add your sending domain, verify it with a TXT record in your DNS, and wait up to 48 hours for data to appear.

In 2025 Google launched Postmaster Tools v2. The old Domain Reputation and IP Reputation dashboards were retired. A new Compliance Status dashboard took their place and checks whether you meet Gmail’s sender requirements.

If your WordPress emails are missing, stuck in spam, or bouncing, Postmaster Tools will tell you why. Fixing the cause is usually a job for WP Mail SMTP, which handles the authentication and list-unsubscribe headers that Gmail now requires.

Fix Your WordPress Emails Now

What Is Google Postmaster Tools?

Google Postmaster Tools is a free reporting dashboard that shows you how Gmail treats email from your domain. It covers spam complaint rates, authentication success, encryption, delivery errors, and (as of 2025) whether you comply with Gmail’s sender requirements.

The data only applies to messages sent to personal Gmail accounts (addresses ending in @gmail.com or @googlemail.com). If a user reads their custom domain email inside the Gmail interface, that still counts. Given that Gmail handles roughly 30% of global email traffic and processes about 121 billion messages a day, it’s worth paying attention to.

There is no paid version. There is no upgrade path. Postmaster Tools is a diagnostic, not a fix. If the numbers look bad, you change what you send and how you send it, not what you pay.

What’s New in Postmaster Tools v2

Google redirected all users to the v2 interface on September 30, 2025. If you set up Postmaster Tools before that date, most of your dashboards carried over. Two didn’t.

Here’s what changed:

The loss of the reputation dashboards was the biggest change. For a decade, those High/Medium/Low/Bad ratings were the quickest way to diagnose a deliverability problem. Google removed them because reputation scores were often slow to update, hard to act on, and only one piece of a more complex picture.

In their place, the Compliance Status dashboard gives you a direct pass/needs work verdict against Gmail’s bulk sender rules. It’s blunter, and in some ways more useful.

It matters more than it used to. In November 2025, Gmail stopped routing non-compliant bulk mail to the spam folder and started rejecting it outright with 4xx or 5xx SMTP errors. Emails that fail authentication now bounce back instead of landing in spam where someone might eventually find them. Postmaster Tools is where you catch that before your customers do.

If you had automations or monitoring scripts pulling v1 API data, those stopped working too. The v2 API has a different schema, and the reputation endpoints are gone permanently. There’s no replacement.

Do You Need to Set Up Postmaster Tools?

If your WordPress site sends any of the following, yes:

• Newsletter or marketing emails via a WordPress email plugin
• WooCommerce order confirmations and receipts
• Password resets and admin notifications
• Form submissions from contact forms or lead magnets
• Notifications from membership or LMS plugins

You don’t have to be a high-volume sender. Postmaster Tools will show partial data from around 100 daily emails to Gmail users, and fuller data closer to the 5,000-per-day threshold that Google uses to define bulk senders.

Smaller sites often skip it, then scramble when an important transactional email (a receipt, a password reset, a form notification) lands in spam. Setting up Postmaster Tools early means you catch deliverability issues before your customers do.

If you’re sending fewer than a handful of emails a day to Gmail recipients, you can still verify your domain now so the data is there when your list grows. Just know you’ll see a message like this until your volume picks up:

No data to display at present. Please come back later. Postmaster Tools requires your domain to satisfy certain conditions before data is visible for this chart.

Before You Start

You need three things before you set up Postmaster Tools:

1. A Google account. A personal Gmail address works fine. If you use Google Workspace, use that instead since you can add team members later.
2. Access to your domain’s DNS settings. You’ll add a TXT record to verify ownership. This is usually through your domain registrar (GoDaddy, Namecheap, Cloudflare, etc.) or your web host.
3. SPF and DKIM configured on the domain you’re sending from. Without authentication, Postmaster Tools won’t show useful data. If you haven’t set this up yet, do that first. WP Mail SMTP’s Gmail, Amazon SES, and SendLayer mailers handle SPF/DKIM for you as part of the setup, which removes about 80% of the friction.

If you’re not sure whether your WordPress emails are authenticated, send a test email to a Gmail address, open it, and check the source. If you see spf=pass and dkim=pass, you’re ready to go.

How to Set Up Postmaster Tools (Step by Step)

Here’s the full setup flow in the v2 interface.

Step 1: Sign in at postmaster.google.com

Go to postmaster.google.com and sign in with your Google account. If you already use Google Analytics or Search Console for the same domain, use the same login. Verification is often automatic when you do.

Step 2: Add your sending domain

Click the + button in the bottom right. In the Getting started window, enter the domain that your emails come from. This should match the domain in your SPF or DKIM records, not the domain on your marketing page (although they’re often the same).

A few rules of thumb:

• Use your root domain (example.com) if that’s where your SPF and DKIM are configured.
• Use a subdomain (mail.example.com or news.example.com) if you send marketing email from a subdomain.
• You can add both and monitor them separately.

Click Next to move to verification.

Step 3: Verify your domain with a TXT record

If the domain is already verified for another Google service, you’ll skip this step entirely and see a confirmation screen. Done.

If not, Google gives you a TXT record that looks like this:

google-site-verification=XxXxXxXxXxXx

Copy it, then open the DNS settings for your domain in a new tab. Add a new TXT record with these values:

The @ in the Name field means the record applies to your root domain. Most registrars fill this in automatically. If yours doesn’t, type @.

Save the record. Cloudflare usually propagates changes in seconds. Other registrars and hosts can take anywhere from 10 minutes to 48 hours.

Switch back to Postmaster Tools and click Verify. If the record hasn’t propagated yet, wait a few minutes and try again.

Step 4: Give other people access (optional)

If you want your marketing team or a developer to see the dashboards, you can add them from the domain management page.

Click the three dots next to your domain, choose Manage users, and enter their Google account email address. They won’t get a notification, so send them a message so they know. They’ll see your domain the next time they sign in to Postmaster Tools.

Step 5: Wait for data

Once your domain is verified, Google starts collecting data from the next email you send to a Gmail address. Most dashboards need 24 to 48 hours to populate. The Compliance Status dashboard uses a rolling average over multiple days, so give it at least a week before drawing conclusions.

That’s the setup done. The rest is interpretation.

How to Read the Postmaster Tools v2 Dashboards

Postmaster Tools is more useful as a daily glance than a deep weekly audit. Most of the time everything is fine. What you’re looking for is the moment something changes.

Here’s what each dashboard tells you, what the thresholds are, and what to do when something looks off.

Compliance Status

This is the dashboard that replaced reputation. It checks whether your sending meets Gmail’s bulk sender requirements and gives each requirement one of three statuses:

• Compliant. You’re meeting the requirement. No action needed.
• Needs work. You’re failing the requirement and Gmail wants you to fix it.
• No data found. Not enough volume to evaluate yet.

The requirements checked include SPF and DKIM authentication, DNS records, message formatting, encryption, and a user-reported spam rate below 0.3%. For bulk senders, it also checks DMARC authentication, one-click unsubscribe, and whether you honor unsubscribes within 48 hours.

Fix any Needs work entries first. They’re the ones most likely to tank your deliverability.

One quirk: changes can take up to seven days to reflect in the dashboard because it uses a rolling data average.

Spam Rate

Spam rate is the percentage of emails recipients manually mark as spam, measured against emails delivered to their inbox.

• Below 0.1%. Healthy. Keep going.
• 0.1% to 0.3%. Watch closely. One more bad campaign and you’re in trouble.
• Above 0.3%. Gmail starts actively filtering you. Fix it now.

A single spike isn’t always a disaster because Google measures each day in isolation. A consistent upward trend is.

The usual causes: you imported a list without consent, you’re emailing inactive subscribers, or the content doesn’t match what people signed up for. Clean the list, tighten the opt-in, and make the unsubscribe link easy to find. More on that below.

Authentication

The Authentication dashboard shows the percentage of your emails that pass SPF, DKIM, and DMARC checks. You want all three sitting near 100%.

SPF tends to run lower because it breaks when emails are forwarded. DKIM and DMARC should be at 95% or higher if set up correctly.

If DKIM suddenly drops, check your DNS first. A record that got changed, deleted, or rotated by a third-party sender is the usual suspect. If you need a refresher on how these records work, we wrote a full guide to DMARC, SPF, and DKIM.

Encryption

Shows the percentage of your email sent over a secure TLS connection. It should sit at or very near 100%.

If it drops, someone in your sending stack is using an outdated SSL connection instead of TLS. Check the SMTP settings in every tool that sends from your domain, including your email marketing platform, any transactional email services, and WP Mail SMTP’s mailer configuration.

Delivery Errors

This is the most useful dashboard when something is actively broken. It shows you the percentage of authenticated emails that were rejected or temporarily failed.

Click any spike and Postmaster Tools shows you the reason. The three error messages you’ll see most often:

421-4.7.0 unsolicited mail originating from your IP address...
550-5.7.1 Our system has detected an unusual rate of unsolicited mail...
550-5.7.26 This mail is unauthenticated...

The first two are reputation issues (slow down, clean your list). The third is an authentication problem (check your SPF and DKIM records).

For a full breakdown of what to do when Gmail blocks your emails, see our guide to fixing Gmail blocking emails.

Feedback Loop

The Feedback Loop dashboard shows spam complaints broken down by campaign. You only get data here if your email service provider stamps emails with a Feedback-ID header. Most major ESPs do, but if you’re only sending transactional WordPress email, you probably won’t see data in this dashboard.

Not a problem. Most WordPress sites don’t need it.

Troubleshooting: When Postmaster Tools Doesn’t Work

Three things go wrong most often during setup. Here’s how to handle them.

Your domain won’t verify

Wait a few minutes and try again. DNS propagation usually takes less than an hour, but it can take up to 48 hours on some hosts. If you’re past the 48-hour mark:

• Check the TXT record value character by character. A missing dot or an extra space breaks it.
• Make sure you added the record to the root domain (@), not to a subdomain.
• Use Google’s Dig tool to confirm the TXT record is actually live.
• If you use a DNS provider like Cloudflare, confirm the record isn’t proxied (toggle off the orange cloud for TXT records).

Your dashboards are blank

Three possible reasons:

1. Your volume is too low. Postmaster Tools needs roughly 100+ daily emails to Gmail users before most charts populate, and 5,000+ for the Compliance Status dashboard.
2. Your SPF or DKIM setup is broken. Postmaster Tools only counts authenticated email. If none of your emails are passing authentication, none of them show up in the data.
3. Your emails aren’t actually reaching Gmail. If your WordPress host is blocked, connections are failing, or your mail is bouncing before it gets to Google, there’s nothing for Postmaster Tools to measure.

Run a test. Send an email from your site to a personal Gmail address, open it, and view the source. If SPF and DKIM both pass, Postmaster Tools will pick it up eventually.

Compliance Status shows “Needs work”

Click the specific requirement that’s failing. Google explains what it wants. Fix it. Then wait up to seven days for the dashboard to reflect the change.

If “Honor unsubscribe” shows Needs work, it means your system isn’t processing unsubscribe requests within 48 hours. Check that your ESP is receiving and actioning one-click unsubscribe headers, and that nothing (like a Cloudflare rule or a firewall) is blocking the POST requests Gmail sends.

How WP Mail SMTP Helps You Stay Compliant

Postmaster Tools diagnoses the problem. WP Mail SMTP is usually the fix on WordPress.

Here’s why it matters for each of the compliance dashboard’s requirements:

Authentication. WP Mail SMTP’s supported mailers (including Gmail, Google Workspace, Amazon SES, SendLayer, Mailgun, Microsoft 365, and others) handle SPF and DKIM properly when you connect them. You stop relying on your web host’s default wp_mail() function, which often sends unauthenticated email from the server’s IP address and goes straight to spam.

List-unsubscribe headers. WP Mail SMTP preserves the list-unsubscribe headers that your email marketing provider adds. That’s the one-click unsubscribe link Gmail now requires at the top of every bulk message.

If your current SMTP plugin strips that header, your emails fail Gmail’s bulk sender compliance checks and you’ll see Needs work in Postmaster Tools.

Delivery errors. WP Mail SMTP’s email logs record every email your site tries to send, including failures. When Postmaster Tools flags a delivery errors spike, you can cross-reference the logs and see exactly which emails were affected and why. Without logs, you’re guessing.

Alerts. Email failure alerts in WP Mail SMTP Pro notify you via Slack, SMS, Discord, or email when sending stops working. Postmaster Tools updates once a day; alerts update in real time.

If you haven’t set up a dedicated SMTP plugin yet, start with WP Mail SMTP. The free version covers authentication for most WordPress sites. The Pro version adds the logs, alerts, and backup connections that make Postmaster Tools data easier to act on.

Once Postmaster Tools is running, check it once a week. Most of the time there’s nothing to see, which is the point. The value comes from noticing the moment something changes, so you can fix it before your customers notice their password reset emails never arrived.

If your Compliance Status shows any Needs work flags, start there. They’re the changes most likely to move your deliverability.

And if your WordPress emails are disappearing into spam or not sending at all, get WP Mail SMTP sorted first. You can’t read Postmaster Tools data on emails that never made it out the door.

Fix Your WordPress Emails Now

Next, Learn How To Create a DMARC Record

A good follow-up read is how to create a DMARC record. DMARC is one of the compliance requirements Gmail checks in Postmaster Tools v2, and it’s the one most WordPress sites either haven’t set up or have configured wrong. The guide walks through building the record, choosing a policy (none, quarantine, or reject), and reading the aggregate reports once they start coming in.

Ready to fix your emails? Get started today with the best WordPress SMTP plugin. If you don’t have the time to fix your emails, you can get full White Glove Setup assistance as an extra purchase, and there’s a 14-day money-back guarantee for all paid plans.

If this article helped you out, please follow us on Facebook and Twitter for more WordPress tips and tutorials.