What are Gmail “reason codes”?

Still have a question, spotted an error, or have a better explanation or a source we should cite?

When Gmail rejects your email, it doesn't just say no. It says no with a code that tells you why. These are Gmail's enhanced status codes, and they're genuinely useful for diagnosing exactly what went wrong.

The format is three numbers separated by dots, embedded in the SMTP response. Here are the ones you'll actually encounter:

5.7.1. Generic policy rejection. Gmail decided not to accept the message but isn't being specific about why. Often a reputation problem.

5.7.26. Authentication failure. Your message passed neither SPF nor DKIM, failed SPF on a domain whose SPF record is set to hard fail (-all), or failed your domain's DMARC policy. Check SPF, DKIM and DMARC.

5.7.27. SPF problem. Your message didn't pass SPF. Your sending IP isn't listed in your domain's SPF record, or your SPF record has an error. At other providers, 5.7.27 can also mean your sending domain has a null MX record, which says the domain takes no mail.

5.7.28. Too much unwanted mail. Gmail has seen an unusual rate of unsolicited email from your IP address and is blocking it. This is not an authentication problem. Stop and look at where your list came from, then check your spam complaint rate in Google Postmaster Tools.

5.7.30 (or 4.7.30). DKIM problem. Your message didn't pass DKIM. The signature is missing or invalid. The 4.7.30 version is a temporary warning, the 5.7.30 version is a block.

5.1.1. The recipient address doesn't exist. Hard bounce.

4.x.x codes. Temporary failure. Gmail is saying "try again later." Not a permanent rejection. Your sending infrastructure should queue and retry automatically.

More codes from Google's own list

421 4.7.0 or 550 5.7.1 with "very low reputation" in the text. Gmail thinks your IP or domain reputation is very low. The 421 is a warning, the 550 is a block. Do not suppress the address. Check Google Postmaster Tools, slow down, and clean your list.

450 4.2.1. The person you are writing to is getting email too quickly. Your sender will retry. Do not suppress the address.

451 4.3.0. Gmail's server temporarily turned the message away. Your sender will retry.

451 4.7.23. Your sending IP has no PTR (reverse DNS) record. This is the warning. The block is 5.7.25. Your email platform sets up the PTR record.

4.7.24 or 5.7.24. Your SPF record has one or more suspicious entries. Clean it up so it only lists the services you really send from.

421 4.7.26. Gmail is slowing you down because your email passed neither SPF nor DKIM. Fix your authentication before it becomes a 5.7.26 block. A 451 4.7.26 is different. A temporary DNS failure stopped Gmail checking your domain's DMARC policy. Let it retry, and check your DNS if it keeps happening.

421 4.7.27. Gmail is slowing you down because SPF didn't pass. Fix your SPF record.

4.7.29 or 5.7.29. You didn't send over a TLS (encrypted) connection. Turn on TLS for sending, or ask your email platform to.

4.7.32 or 5.7.32. The domain in your From address doesn't match the domain that passed SPF or DKIM. Line them up so your mail passes DMARC alignment. The 4.7.32 version is a warning, the 5.7.32 version is a block.

4.7.40 or 5.7.40. Your sending domain has no DMARC record, or its DMARC record sets no policy. Publish one with a policy. The 4.7.40 version is a warning, the 550 5.7.40 version is a block. A 504 5.7.40 is something else. The login method your sending tool used is not supported, so fix its login settings.

553 5.1.7. Your own sender address is invalid. Fix the From address in your sending setup.

550 5.4.5. You hit your own daily sending limit in Gmail or Google Workspace. Wait until tomorrow, or send campaigns through an email platform instead.

554 5.6.0. The email itself is badly built and Gmail won't take it. Fix the code or the template.

550 5.7.25. Your sending IP has no PTR (reverse DNS) record. Gmail requires one. Your email platform sets it up.

You'll see these codes in your ESP's bounce log or in your mail server logs. If you're on a cloud ESP, look for the raw bounce message. Most platforms expose it. You can also check Google Postmaster Tools (free) for a broader view of how Gmail sees your domain over time. If you're hitting 5.7.26, 5.7.27, or 5.7.30, our free SPF checker and DMARC parser can help diagnose which authentication record is the problem.

The Email Almanac Field Notes: the most useful email questions, once a month

One email a month. New questions worth reading, real deliverability changes (Gmail and Outlook updates, etc.), and any tool or report that landed since the last issue. No fluff, no upsell.

Contributors

Who worked on this answer

Every name links to their profile. Every company links to their site. Real people, real accountability.

Ask an AI · tailored to your setup

Decode Gmail reason codes and prioritize fixes.

I'm seeing Gmail rejection errors in my bounce logs. The error code I'm getting is paste the full rejection message or just the code. My sending setup: describe your ESP, domain, and authentication status. What does this code mean specifically, and what should I check or fix first to resolve it?

Edit the yellow boxes, then send to the AI of your choice.