Deliverability

What is a spam complaint rate, and what threshold do Gmail and Yahoo enforce?

A spam complaint rate is the share of your delivered messages that recipients reported as spam by pressing the button in their mail client. It is the single most direct signal a mailbox provider has about whether people want your mail, which is why both providers that publish a bulk-sender requirement put a number on it.

What number do they publish?

Two different ones, measured slightly differently.

Google publishes a target and a ceiling in the same sentence:

Keep spam rates reported in Postmaster Tools below 0.10% and avoid ever reaching a spam rate of 0.30% or higher.

Yahoo publishes a single figure in its sender best practices:

Keep your spam rate below 0.3%

The gap is not a rounding difference. Under Google's wording, 0.2 percent is above the target while being under the ceiling, and a sender who takes Yahoo's number as universal is running at twice Google's recommended level while believing they are compliant.

For a sense of scale, 0.3 percent is three complaints per thousand delivered messages. On a send of fifty thousand it is fifteen people. Complaint rate is a metric where very small absolute numbers carry the decision.

What exactly is being counted?

Manual reports, on mail that made it to an inbox, from a subset of your messages.

Google's own definition of the figure narrows it three times over:

The spam rate is the percent of your messages that are delivered to engaged recipient's Inbox and then marked as spam by the recipient. Messages sent to spam and then marked as not spam by recipients count toward messages delivered directly to the inbox. Postmaster Tools displays the spam rate of DKIM-authenticated messages sent to Gmail accounts.

Three consequences follow, and each one has misled somebody.

  • Automatic filtering is not a complaint. If Gmail sends your mail to the spam folder itself, no complaint is recorded, because nobody had the chance to press the button.
  • Only DKIM-authenticated mail is measured. Mail that fails to authenticate does not appear in the figure at all.
  • The denominator is inbox deliveries, not sends. So the rate rises when the same number of complaints is spread over fewer inbox placements.

Why did my complaint rate fall while everything got worse?

Because the denominator collapsed, and Google warns about this directly:

If Gmail automatically sends a significant number of your messages to spam, the rate shown in the dashboard might seem low, because recipients get fewer of your messages in their Inbox.

They add a second warning for the extreme case: "if your spam rate is extremely low, something might be impacting the accuracy of the data."

So a complaint rate is only meaningful read alongside placement and reputation. A rate of zero on a domain with a poor reputation rating is not a clean bill of health, it is a sender whose mail has stopped reaching anyone who might object. Reading the Postmaster Tools dashboards together is the way to catch that.

Where do I see the number?

From the provider, because only the provider can see the button.

There is no way to compute a complaint rate from your own sending logs. Two channels exist:

  • The provider's dashboard. Google reports it in Postmaster Tools, per domain, for mail to Gmail only.
  • A feedback loop. Yahoo runs a Complaint Feedback Loop that sends you a copy of each complaint once you have signed your mail with DKIM, and describes it as a requirement rather than a nicety: "An active CFL is needed for all DKIM domains to make sure you're processing complaints quickly."

Bird surfaces the aggregate on the Metrics page and suppresses a complaining recipient automatically, so a complaint stops the next marketing send to that address without you writing any code.

How do I bring it down?

By changing who is on the list, which is slower and more effective than changing the mail.

A complaint is nearly always one of two things: someone who never meaningfully agreed to hear from you, or someone who did and cannot find the unsubscribe link. Both are acquisition and design problems rather than content problems.

Google's own recommendations for a high spam rate are entirely about the list:

  • Send email only to recipients who want to get messages from you.
  • Make sure recipients opt in to get messages from you.
  • Confirm each recipient's email address before subscribing them.
  • Periodically send messages to confirm that recipients want to stay subscribed.
  • Consider unsubscribing recipients who don’t open or read your messages.
  • Make it easy to unsubscribe.

The last one is the fastest lever. A recipient who cannot find the unsubscribe link reports spam instead, which costs you far more than the opt-out would have. One-click unsubscribe is the mechanism, and on marketing mail Bird adds it for you.

Recovery is slow by design. Google notes that after fixing the cause you should "wait up to 7 days for the spam rate to reach a level that falls within compliance", and that a sustained high rate leaves a mark: "It can take time for improvements in spam rate to reflect positively on spam classification."

Bouw op hetzelfde netwerk.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra u een betaalmethode toevoegt en een afzender verifieert.

Begin met één kanaal.
Voeg de rest toe wanneer je er klaar voor bent.

Een test-API-key is direct beschikbaar. Productietoegang wordt ontgrendeld zodra je een betaalmethode toevoegt en een afzender verifieert.

Gebruik je Claude Code, Cursor of Codex? Kopieer een setup-prompt en je agent installeert de Bird CLI en skills voor je. Kies de jouwe:

Cursor