Skip to content
Warmuply

Google Postmaster Tools Setup: A Beginner’s Guide

The Warmuply TeamLast checked: October 2026

Google Postmaster Tools is Google’s free dashboard for people who send email to Gmail users. It shows how many people mark your email as spam, whether your domain settings pass Gmail’s checks, and why messages fail to arrive. This guide covers Google Postmaster Tools setup from start to finish, then explains what to look at once it’s running.

It’s written for business owners, founders, recruiters and small teams sending a mail merge from their own Google Workspace address. If you can add a record to your domain settings, you can do this.

What is Google Postmaster Tools?

Postmaster Tools reports on email you send to personal Gmail accounts: addresses ending in @gmail.com or @googlemail.com. It doesn’t cover email to business addresses, even ones that run on Google Workspace, and it doesn’t cover Outlook or Yahoo.

Who it reports on

Senderyou@yourcompany.com
Counted in Postmaster Tools
  • name@gmail.comPersonal Gmail
  • name@googlemail.comPersonal Gmail
Not counted
  • name@[work domain]on Google Workspace
  • name@outlook or yahoo address
Postmaster Tools only sees the part of your list that uses personal Gmail.

If you mostly email people at work addresses, it only sees the slice of your list on personal Gmail.

What it does give you is Gmail’s own data, which no other tool has:

  • your spam rate: the share of your email that people mark as spam
  • whether you meet Gmail’s sender requirements (the rules Google sets for anyone emailing Gmail users)
  • whether your email passes SPF, DKIM and DMARC (settings on your domain that prove your email really comes from you)
  • why some messages were rejected or delayed

What you need before you start

  • A Google Account or Google Workspace account. Your work account is fine.
  • Access to your DNS settings. DNS is the set of records that tells the internet how your domain (the yourcompany.com part of your address) works. You change it wherever you manage your domain, which is often the company you bought it from.
  • DKIM turned on for your domain. Several dashboards, including spam rate, only count email signed with DKIM. If you haven’t turned it on yet, follow our guide on turning on DKIM in Google Workspace first.

Which domain should you add? Google says to add the domain that signs your email with DKIM, or the one used for SPF. If you send from you@yourcompany.com through Google Workspace with DKIM turned on, that’s simply yourcompany.com.

Google Postmaster Tools setup, step by step

Setup has four steps, and the last one is optional. Open your DNS settings in another browser tab before you begin.

Setup

  1. 1

    Add your domain

    yourcompany.com
  2. 2

    Copy the code

    google-site-verification=…
  3. 3

    Add it to your DNS settings, then verify

    TypeTXTHost@Verified
  4. 4

    Give others access (optional)

    name@yourcompany.com
Setup is four steps. The only fiddly part is pasting one record into your domain settings.
  1. Add your domain. On a computer, sign in to Postmaster Tools at postmaster.google.com. On the Manage Domains page, click Add new domain, type yourcompany.com, then click Create. Click Back to return to your list of domains.
  2. Copy the verification record. Next to your domain, click More options (the three dots), then Verify domain. Google shows a TXT record (or a CNAME record) to copy. A TXT record is a line of text you add to your DNS settings to prove you own the domain.
  3. Add it to your DNS settings, then verify. In your DNS settings, add a new TXT record. Leave the host or name field blank, or enter @, and paste Google’s code as the value. Save it, go back to Postmaster Tools, and click Verify.
  4. Give others access (optional). Next to your domain, click More options, then Manage users, then New user, and enter their Google email address. Postmaster Tools doesn’t tell them, so let them know yourself.

The record you add looks like this, with your own code from Google in place of the brackets:

Type:  TXT
Host:  @
Value: google-site-verification=[your unique code from Google]

Google says verification usually happens right away, though the status can take up to 10 minutes to update. If your DNS host is slow to publish new records, Google’s Workspace help says a new TXT record can take up to 72 hours to be recognized. Leave the record in place; don’t merge it into your SPF or DMARC record.

If verification fails, check the code was pasted exactly, wait a few minutes, and try again, or with a new code.

Sending from a subdomain such as news.yourcompany.com? Add yourcompany.com first. Once that’s verified, you can add the subdomain the same way without verifying it again.

Why does Postmaster Tools show no data?

The most common reason is that you haven’t sent enough email to personal Gmail addresses yet. To protect Gmail users’ privacy, Google leaves gaps on days when your volume is low. Google doesn’t publish a minimum number.

Other reasons:

  • It’s too soon. Data isn’t live. Google says it’s usually updated within 24 hours, and can take longer.
  • Your list is mostly business addresses. Email to work addresses isn’t counted, even if they use Google Workspace.
  • DKIM isn’t on, or you added a different domain from the one that signs your email.

A mail merge of a few dozen or a few hundred people, with only some of them on personal Gmail, may show patchy data or none. Set it up anyway; it’s free, and ready when your volume grows.

What each Postmaster Tools dashboard shows

Pick your domain, a dashboard and a time range (7 to 120 days) from the menus at the top. These are the dashboards that matter most for mail merge senders:

DashboardWhat it showsShould you check it?
Compliance statusWhether you meet Gmail’s sender requirements, item by item, marked Compliant, Needs work or No data foundYes, weekly
Spam rateThe share of your email that people marked as spamYes, weekly
AuthenticationThe share of your email passing SPF, DKIM and DMARCYes, after any DNS change
Delivery errorsThe share of your email Gmail rejected or delayed, and whyYes, if replies drop
Encryption, Feedback loopSecure connections, and spam rates per campaignRarely, for most mail merge senders

Under Compliance status, the Deliverability analysis gives Google’s recommendation for your domain. It can flag that you send too little email, exceed the recommended spam rate, or don’t meet the sender guidelines.

Fixes take time to show. Google says the Compliance status dashboard can take up to 7 days to reflect a change, because it uses an average over several days. The dashboard reports on your main domain only, not subdomains.

What happened to domain reputation in Gmail?

Google is retiring the Domain Reputation and IP Reputation dashboards. Depending on when you sign in, you may still see a domain reputation chart, or it may be gone. Either way, don’t build your routine around it.

Google’s reasons: the scores were hard to act on, slow to reflect changes, and misleading, since reputation is only one of many things that affect delivery.

Your domain reputation in Gmail still exists; Google just shows it differently now. Watch these instead:

  • Spam rate, which is the clearest signal you control
  • Compliance status, for whether your setup meets Gmail’s rules
  • Delivery errors, which can name low domain reputation as the reason a message was rejected

How to read your spam rate

Google’s sender guidelines ask you to keep your spam rate below 0.10% and never let it reach 0.30%.

Spam rateOut of 1,000 emailsWhat it means
Below 0.10%Fewer than 1 reportHealthy. Keep doing what you’re doing
0.10% to 0.29%1 or 2 reportsAct now, before it climbs further
0.30% or higher3 or more reportsGoogle says never reach this. More of your email will go to spam

Spam rate

Google’s guidance
  • Aim to stay hereBelow 0.10%
  • Act now0.10% to 0.29%
  • Never reach this0.30% or higher
Google’s guidance: stay below 0.10%, and never reach 0.30%.

One catch: the spam rate only counts email that reached the inbox and was then reported. If Gmail is already sending much of your email to spam, fewer people see it, so the rate can look low. A sudden drop to zero after a high rate can mean the same thing. If the number looks too good, run a test send and check where it lands.

What to do if your spam rate climbs

Spam reports come from the people you email, so fix your list and your message:

  1. Email only people who expect to hear from you, or who would reasonably welcome it. Never use bought or scraped lists.
  2. Make it easy to opt out, and stop emailing anyone who asks.
  3. Write like a one-to-one email. Keep links to one or two, skip attachments, and avoid fake “Re:” subject lines.
  4. Send at a steady pace instead of big bursts, and increase volume slowly.

Words matter less than most people think. Pushy or misleading wording mostly hurts because it makes people click “Report spam”.

Our guide to spam trigger words explains which patterns cause trouble and why.

If your email is already landing in spam, work through our list of causes and fixes for Google Workspace emails going to spam.

What warmup can and can’t fix

Warmup builds trust in your inbox. It can’t make people want an email they didn’t expect, and it can’t lower a spam rate driven by the wrong list.

Warmuply helps withOnly you control
Building a sending history for a new or quiet inboxWho you email
Knowing how many emails are safe to send todayWhether people report your email as spam
Checking SPF, DKIM and DMARC, with the exact text to pasteWhat your email says and how it looks
Placement tests at Gmail, Outlook and Yahoo, and same-day blacklist alerts (a blacklist is a list of domains flagged for sending spam)Honoring requests to stop emailing

Postmaster Tools and Warmuply fill different gaps. Postmaster Tools gives you Gmail’s view, a day or more behind. Warmuply gives you a daily safe-send number and placement tests that cover Outlook and Yahoo too.

If your inbox is new or hasn’t sent in bulk before, our guide on how to warm up a new Google Workspace email explains how to build up volume safely.

Before you hit send

  • Postmaster Tools is set up and verified for the domain that signs your email with DKIM.
  • Everyone on your list knows you or expects to hear from you, and there’s an easy way to opt out.
  • Your last spam rate was below 0.10%, or you know why there’s no data yet.
  • SPF, DKIM and DMARC all pass. Check them with our free domain checker.

Then start a free 7-day trial of Warmuply to see your safe-send number each day. No card needed.

Frequently asked questions

Yes. Google doesn’t charge for it. You need a Google Account or a Google Workspace account to sign in, and access to your domain’s DNS settings so you can add the verification record.

No. It only reports on email sent to personal Gmail addresses ending in @gmail.com or @googlemail.com. To see where your email lands at Outlook and Yahoo, send a test to inboxes there or run a placement test that covers them.

Not to verify your domain. Google’s sender guidelines only require DMARC for senders sending about 5,000 or more emails a day to Gmail accounts, but Google recommends every domain sets it up. A DMARC policy of p=none is enough to start.

Postmaster Tools uses Coordinated Universal Time (UTC), not your local time zone. If you send in the evening in the US, that email may count toward the next day’s data. Data is also usually updated within 24 hours, so the newest day can lag.

Google says it means there weren’t enough suitable emails to judge that particular requirement yet. For settings-based checks, the status reflects your settings when the emails arrived, not what’s in your DNS right now. Check again after you’ve sent more email to Gmail addresses.

Sources (6)

Get your inbox ready before you send.

Warmuply warms up your Google Workspace inbox in the background and shows you how many emails you can safely send each day.

Start free for 7 days

No credit card required.

We're launching soon

Get on the waitlist for an exclusive launch discount.

We'll only email you about the launch.