← Back to Blog

Your email lands in Gmail's Promotions tab: what actually moves it, and what is folklore

  • Gmail
Your email lands in Gmail's Promotions tab: what actually moves it, and what is folklore

Every few weeks a client forwards us the same screenshot: their own newsletter, sitting in the Promotions tab of their own Gmail. The question underneath is always "is something broken?"

Usually nothing is broken. Promotions is part of the inbox, not the spam folder. Most of the advice circulating about how to escape it is folklore that got repeated until it sounded like documentation. Here is what the primary sources actually support, what they do not, and the order we work through it on a client account.

Promotions is not spam, and the difference decides what you fix

Gmail sorts incoming mail into categories: Primary, Promotions, Social, Updates and Forums. Google's help page for categories describes the sorting as automatic, and tells the user to move a message when it lands in the wrong place so that Gmail learns their preference. Every one of those categories is the inbox. The message was delivered. It is searchable, it fires a notification on most setups, and it counts as inbox placement by any sane definition.

The spam folder is a different outcome produced by a different set of signals: authentication failures, complaint rates, domain and IP reputation. This distinction is not academic. It decides which week of work you do next. We have watched a small business rewrite every subject line it owned for a month while its real problem was an unsigned third-party sender.

So establish which problem you have before anything else. If the mail arrives and you can find it under Promotions, you have a categorisation question and this post is the right one. If it never arrives, or it lands in Spam, or you are getting bounces, start with the 550 5.7.1 reputation guide instead.

What Google actually says decides the category

Google does not publish the classifier, and anyone who tells you they have reverse engineered it is selling something. What the help documentation does state is narrower and more useful: the sorting is automatic, and when a person moves a message to a different category, Gmail uses that choice to sort mail from that sender for that person in future. The same page walks users through turning categories off entirely, or building a filter that assigns one.

Read that carefully and you land on the thing most Promotions-tab advice quietly ignores. Category is a property of the relationship between one sender and one recipient, not a property of your message. Two people on the same list can receive a byte-identical message and see it in two different tabs, and both outcomes are correct. Any tool or agency promising to "move your emails to Primary" is promising something no sender controls.

What a sender does control is whether the mail describes itself honestly: authentication that proves the domain, a list of people who asked for it, an unsubscribe that works on the first click, and content that earns opens and replies. Those are worth doing whatever tab you end up in, because they are the same signals that keep you out of Spam.

Five claims that do not survive a look at the sources

These come up in almost every conversation we have about the Promotions tab. None of them has a primary source behind it, and two of them are actively harmful.

  • "Remove the unsubscribe link and you will land in Primary." Google's sender guidelines require marketing and subscribed messages to include a clearly visible unsubscribe link in the message body and to support one-click unsubscribe. Stripping it does not buy Primary. It puts you on the wrong side of a published requirement and pushes people toward the spam button, which is the one signal that genuinely hurts you.
  • "One image, no links, and you are safe." No primary source ties tab placement to an image count or a link count. What a single-image email does reliably is break for anyone using a screen reader and turn into a blank rectangle for anyone with images off. You would be trading a measurable accessibility loss for an unmeasurable guess.
  • "Avoid the word free." Word-level triggers are a carry-over from the keyword filters of twenty years ago. Nothing in Google's current sender documentation describes a banned vocabulary, and writing around a word list makes copy worse in ways your readers can feel.
  • "Ask your whole list to drag you to Primary." This one is half true, which is why it survives. Moving a message does teach Gmail that recipient's preference, and Google documents exactly that. It works for the one person who does it. As a campaign it converts at a rate that rarely justifies the effort, and it does nothing for next month's subscribers.
  • "Plain text always lands in Primary." Plenty of plain-text bulk mail sits in Promotions, and plenty of styled transactional mail sits in Primary. The format is not the lever.

Annotations: design for the tab instead of fighting it

There is a documented way to make a promotional message work harder inside the Promotions tab, and it comes from Google. The Gmail developer documentation for Promotions tab annotations describes markup, expressed as JSON-LD or microdata in the message, that lets Gmail surface a preview image, a deal with its discount code and expiry date, and a sender logo next to the subject line.

Notice what that is and is not. Google publishing an interface for the Promotions tab is a fairly direct statement that the tab is worth designing for rather than an exile. It is not a route out of it. For a shop or a restaurant sending genuine offers, a week spent on annotations and a cleaner offer is a better investment than a year spent chasing Primary.

Authentication is the floor, not the lever

Since 1 February 2024, Google has required senders of more than 5,000 messages a day to Gmail accounts to authenticate with SPF and DKIM, publish a DMARC record for the sending domain, have valid forward and reverse DNS on the sending IP, transmit over TLS, and keep the spam rate reported in Postmaster Tools below 0.30%. The guidelines add that senders should stay under 0.10% and should never let the rate reach 0.30%.

None of that is a Promotions-tab control, and we want to be honest about that. It is the floor. Fall below it and you will have a delivery problem large enough to hide the tab question completely. If you have no DMARC record yet, the one that starts collecting evidence without changing how anything is delivered looks like this:

_dmarc.example.com.  3600  IN  TXT  "v=DMARC1; p=none; rua=mailto:dmarc@example.com"

A policy of p=none asks receivers to report what they see and to change nothing. Two weeks of those reports will tell you every system sending as your domain, including the invoicing tool and the CRM nobody mentioned in the kickoff call. That inventory is the real deliverable.

One-click unsubscribe, done the way the standard describes

Marketing and subscription mail needs both of these headers, on every message:

List-Unsubscribe: <https://example.com/u/9f2c1b>, <mailto:unsub@example.com?subject=unsubscribe>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

RFC 8058 defines that pair. The second header is the signal that the URL is safe to POST to, which exists because mail software sometimes fetches URLs found in headers and used to unsubscribe people by accident. The sender has to stand up an endpoint that accepts an HTTP POST at that address and must not answer it with a redirect, because redirected POSTs have never worked reliably across clients. Google's guidance is to honour the request within 48 hours and to keep the visible link in the body as well.

This belongs in a post about tabs for one reason. The alternative to an unsubscribe that works on the first click is the spam button, and the spam button is the signal that moves you from a tab you dislike to a folder nobody reads.

Measure instead of guessing

Postmaster Tools reports spam rate, domain and IP reputation, authentication results and delivery errors for mail you send to personal Gmail accounts. It does not report tab placement, and nothing official does. If a dashboard claims to show you your Primary-versus-Promotions split, ask where the number comes from. Usually it is a handful of seed accounts, and a seed account has no history with your domain, which is precisely the input that decides the category for a real subscriber.

The instruments that do tell you something are the ones you already have. Track open and reply rate by segment rather than for the list as a whole, because a tab change shows up as a step down in engagement for one group and not another. Watch the spam rate in Postmaster Tools as an early warning. If you want help reading those graphs, we wrote a walkthrough of the Postmaster Tools dashboards.

What we check on a client account, in order

  1. Which problem it actually is. Delivered to Promotions, or not delivered. Five minutes with a test send and the raw headers settles it.
  2. Every sending source, authenticated. SPF and DKIM passing and aligned for the newsletter platform, the invoicing tool, the CRM, the store and the helpdesk. This is where most of the findings are.
  3. DMARC at p=none with reports going somewhere a human reads. Two weeks of data before any policy change.
  4. The unsubscribe path, end to end. Both headers present, the POST endpoint actually answering, the visible link in the body, and the suppression list honoured inside 48 hours.
  5. The list itself. How addresses were collected, when the dormant segment last opened anything, and whether a purchased list is poisoning a domain that took years to build.
  6. Segmentation and cadence. Sending less mail to people who want it beats sending more to everyone, on every metric that Gmail can see.
  7. Annotations, last. Only once the mail is authenticated, wanted and measurable, and only if it is genuinely promotional.

Notice that Promotions never appears as a target. If the work above is done, the tab sorts itself out for the recipients who care, and the recipients who do not care were never going to convert from Primary either.

How Guanacos Tech helps

We do this work for small and mid-sized businesses across North America and Latin America, in English and Spanish, and it almost always starts the same way: a screenshot, a worry, and an hour of evidence that turns the worry into a short list. If the mail is genuinely being filtered rather than sorted, that is email deliverability consulting for small business and we fix it at the DNS and sender level. If it is sorted into Promotions and the fundamentals are sound, we will tell you so rather than sell you a month of work, and we will show you the evidence. Book a 30-minute call and bring the screenshot and one bounced message if you have one.

Sources

Next step

Would you rather we did this for you?

Thirty minutes on Google Meet, free. We look at your domain or project with you, tell you what is wrong and what we would do first. If you can fix it yourself, we say so.

Book a 30-minute call or read about our email deliverability service

Frequently asked questions

Does landing in the Promotions tab hurt my deliverability?

No. Promotions is part of the inbox, so the message was delivered and is searchable. Deliverability problems look different: mail in the Spam folder, or bounces such as 550 5.7.1. Fix those first, because they hide the tab question entirely.

Can I force my emails into the Primary tab?

No sender can. Google documents that category sorting is automatic and that a recipient who moves a message teaches Gmail their own preference for that sender. Category depends on the sender and recipient pair, so the same message can land in different tabs for different people.

Do Gmail annotations move my email out of Promotions?

No. Annotations are markup Google documents for making a message look better inside the Promotions tab, with a preview image, a deal and a logo next to the subject line. They are a way to work with the tab, not a way to leave it.