Why transactional email lands in Gmail Promotions
Receipts and alerts in the Promotions tab are usually a content and stream problem. The signals Gmail likely uses and changes that tend to help.

On this page(8 sections)
- How Gmail's tabs work, as far as anyone outside Google knows
- Why transactional mail drifts into Promotions
- 1. It looks like marketing
- 2. It shares a domain with marketing
- 3. It includes promotional language
- 4. Many links and images
- 5. The bulk unsubscribe treatment
- Changes that tend to help
- Write subject lines like notifications
- Keep cross-selling separate
- Things that do not reliably work
- Measure before and after
- When Promotions is the correct tab
- Checklist
- Bottom line
Your receipt, password reset or usage alert lands in the Promotions tab, where users rarely look. It was delivered, technically.
It might as well not have been. The fix is usually not a magic header but a mix of how the message is built and what else your domain sends.
How Gmail's tabs work, as far as anyone outside Google knows
Gmail sorts incoming mail in its default inbox into categories: Primary, Promotions, Social, Updates and Forums. Users can turn tabs on or off, and many mobile and desktop clients show them differently.
Google does not publish how its classifier decides. What is publicly known is limited: it uses machine learning over message content and sender signals, and users can retrain it by dragging messages between tabs. Everything else, including the advice below, comes from practitioner experience and testing rather than official documentation. Treat it as likely, not guaranteed.
Two things are worth stating plainly:
- Promotions is not spam. Mail in the Promotions tab was delivered to the inbox; it is just categorized. That matters for compliance and reputation discussions.
- Updates may be the realistic target. Gmail tends to place receipts, confirmations and account notices in Updates rather than Primary when tabs are enabled. For many transactional messages, landing in Updates instead of Promotions is a win.
Why transactional mail drifts into Promotions
1. It looks like marketing
Transactional templates often borrow heavily from marketing design: large hero images, multiple calls to action, product recommendations, discount codes, social icons and a footer full of links. A receipt that is 70% upsell looks, to a classifier, like a promotion.
2. It shares a domain with marketing
If your newsletters and promotions are sent from the same From address, the same DKIM domain and the same infrastructure as your receipts, the sender signal is mixed. Separating streams by subdomain is good for reputation and, many practitioners find, for categorization too.
3. It includes promotional language
Words and structures associated with offers ("limited time," "save 20%," "shop now") push in the promotional direction, especially combined with commercial design.
4. Many links and images
A transactional message with a dozen tracked links and heavy imagery resembles a newsletter more than a notification.
5. The bulk unsubscribe treatment
Messages carrying list-style headers and prominent unsubscribe footers look like subscription mail. Transactional messages that are genuinely transactional often do not need marketing unsubscribe machinery, though product notifications that users can opt out of should still offer a way to do so.
Changes that tend to help
| Change | Why it likely helps |
|---|---|
| Separate subdomain for transactional mail | Clean sender signal, distinct from marketing |
| Plain, focused layout | Looks like a notification rather than a campaign |
| One primary action | Fewer links, clearer purpose |
| Remove upsells and promotions | Removes the most promotional content |
| Lead with the facts | "Your receipt for order 1042" is unambiguous |
| Personal, specific subject lines | Matches transactional patterns |
| Include a plain-text part | Standard for well-formed mail |
| Reasonable image-to-text ratio | Avoid image-only messages |
Write subject lines like notifications
Compare:
Promotional: Thanks for your order! Here's 15% off your next one
Transactional: Your receipt from Example (order 1042)
The second describes what the message is. The first sells.
Keep cross-selling separate
If you want to promote related products, send that as a separate marketing message from your marketing stream, to people who opted in. Mixing it into receipts risks both categorization and complaints.
Things that do not reliably work
- Special headers. There is no documented header that forces Primary placement.
- Asking users to move messages. Instructions to drag your email to Primary can train an individual user's inbox, but they do not scale and they clutter your messages.
- Removing all formatting. Plain text alone does not guarantee Primary, and it can hurt readability. Simplicity helps; austerity is not required.
- Changing words alone. Swapping a few phrases rarely overrides strong sender and structure signals.
Measure before and after
Tab placement is hard to measure directly, which is why opinions about it are so strong. Practical approaches:
- Personal test accounts with tabs enabled, at least a few, used like normal mailboxes. Note where each message type lands before and after changes.
- Seed tests, understanding that seed accounts lack engagement history and may categorize differently from real users.
- Engagement by provider. If open or click rates on transactional mail at Gmail rise after a change while other providers stay flat, categorization may have improved.
Change one thing at a time so you know what made the difference.
When Promotions is the correct tab
Marketing mail belongs in Promotions, and that is fine. Gmail users who want promotional mail know where to find it, and Gmail's Promotions tab supports annotations for offers and images. Trying to force marketing into Primary through disguise tends to erode trust and engagement. Save the effort for messages users actually need to see.
Checklist
- Send transactional mail from a subdomain separate from marketing.
- Strip upsells, discount codes and promotional sections from transactional templates.
- Use one clear call to action and a descriptive subject line.
- Keep imagery modest and include a plain-text alternative.
- Test with real Gmail accounts that have tabs enabled.
- Change one variable at a time and compare engagement at Gmail.
Bottom line
Gmail does not document its tab classifier, but transactional mail that looks and behaves like marketing, or shares a sender with marketing, tends to end up in Promotions. Separate your streams, make transactional templates plain and specific, move cross-sells into their own marketing messages, and aim for Updates or Primary rather than chasing a header that does not exist.
Start with Koltrix
Your domain, one inbox, and an API that sends.
A team inbox where AI sorts and drafts (nothing is sent without your click), plus the transactional API and SMTP relay your product sends with. 7 days free, no card.


