Does Cold Email Need a One-Click Unsubscribe Header?
Google's one-click rule starts above 5,000 Gmail messages a day. What Yahoo, CAN-SPAM and RFC 8058 ask of a founder sending 40 cold emails.

You finished the cold email setup at 11pm. SPF, DKIM and DMARC pass, the sequence is warm, and you send forty emails a day to founders who posted a problem you solve. Then someone in a Slack group says Gmail now requires a one-click unsubsc
You finished the cold email setup at 11pm. SPF, DKIM and DMARC pass, the sequence is warm, and you send forty emails a day to founders who posted a problem you solve. Then someone in a Slack group says Gmail now requires a one-click unsubscribe header and your footer link does not count. You open the tool's docs, find nothing, and consider rebuilding the whole thing. Slow down. Whether cold email needs a one-click unsubscribe header depends on your volume, on what counts as a marketing message, and on three different rulebooks that people blur into one. This post reads each of them off the source.
Google's one-click rule starts above 5,000 messages a day
Google's email sender guidelines put the one-click requirement in the section for senders of more than 5,000 messages a day to personal Gmail accounts. The wording is that marketing messages and subscribed messages must support one-click unsubscribe. Everyone below that line gets a softer instruction: always give recipients an easy way to unsubscribe.
So the Slack answer is wrong for a founder at forty emails a day, and right for a team running several mailboxes into the same domain. Google's threshold counts the primary domain, subdomains included, so ten reps on one company domain add up fast. Google's bulk sender FAQ also says a sender classified as bulk stays bulk.
The two headers are the requirement, and a footer link is not
Here is what Google means by one-click. RFC 8058 defines it, and the example in section 8.1 is two lines:
List-Unsubscribe: <https://example.com/unsubscribe/opaquepart>
List-Unsubscribe-Post: List-Unsubscribe=One-ClickThe mailbox provider reads those headers and can offer its own unsubscribe button. When the recipient clicks it, the provider sends an HTTPS POST to your URL. No landing page, no confirmation step, no login. The RFC adds three details that tools get wrong:
- The
List-Unsubscribe-Postheader must contain exactly the pairList-Unsubscribe=One-Click. - Your URL must answer the POST directly. The RFC says not to respond with an HTTPS redirect, because redirected POSTs have often failed or turned into GETs.
- The message needs a valid DKIM signature that covers both headers. Without it, receivers should not offer one-click.
Google's FAQ settles the footer question in one line: a mailto link in the body of your messages does not meet the one-click requirement. A bulk sender needs the headers plus a visible unsubscribe link in the body, and once the headers exist that link can point to a preferences page.
The footer link is for humans, the header is for Gmail. A bulk sender needs both, and neither replaces the other.
Yahoo asks for the header and a faster honor time
Yahoo's sender best practices tell bulk senders to implement a functioning list-unsubscribe header that supports one-click unsubscribe for marketing and subscribed messages, and to honor unsubscribes within 2 days. It calls the RFC 8058 method highly recommended. The page we read defines no volume threshold, so we cannot tell you where Yahoo draws its bulk line, and we would not repeat anyone's number as Yahoo's.
Google's own FAQ recommends fulfilling unsubscribes within 48 hours, which lines up with Yahoo's 2 days. Outlook now rejects mail that fails authentication for domains above its own 5,000 threshold, so all three big mailbox providers now run some bulk rule. They differ in the details, and none of the details is a reason to stop sending.
CAN-SPAM wants an opt-out, not a header
The law is looser than the providers. The FTC's CAN-SPAM compliance guide says the law makes no exception for business-to-business email, and that your message needs a clear and conspicuous explanation of how to opt out. A return email address or another easy internet-based method qualifies. You may ask the recipient to visit a single web page, but no other step.
You have 10 business days to honor the request, and the mechanism must keep working for at least 30 days after you send. The guide also says each separate email in violation is subject to penalties of up to $53,088. Nothing in it mentions List-Unsubscribe headers. Our deeper read of what CAN-SPAM actually requires covers the other rules, including the physical address.
That gives you three layers. The law sets the legal floor, with a simple opt-out and 10 business days. Mailbox providers set a delivery floor, with headers and 2 days. Gmail and Yahoo can punish you for failing theirs, while the FTC can punish you for failing its own. Hitting only the legal floor works until your volume crosses a provider's line.
Whether a cold email is marketing is the recipient's call
Google's FAQ says the one-click requirement applies only to marketing and promotional messages, and excludes transactional ones such as password resets and form confirmations. Then it adds a line that cold senders should read twice: message recipients, not Google, determine the nature of the messages they receive.
That is our reading, and a deliverability lawyer might phrase it more carefully. We did not find any primary source that lets a high-volume cold sender skip the header by calling the email personal.
Add the header at any volume if your tool offers it
No page we read says a 40-email-a-day sender must have the header. We would still turn it on, for a reason that is ours and not Google's. The number Google and Yahoo both police is the spam rate in the 0.3% range, and the spam button is the only exit most recipients can see. A recipient who can click Unsubscribe without leaving the inbox has less reason to click Report spam instead. We have not seen a primary source that measures the effect, so treat this as judgment.
The cost is small. Most sending tools expose the header as a setting. If yours does not, the work is a signed POST endpoint and two lines in the message headers, and the DKIM signature has to cover them. If you cannot do that today, a plain-text line that says "reply 'no' and I stop" still satisfies the FTC.
Whichever route you take, one suppression list should feed every tool you use, because the strictest clock wins. Suppress within 48 hours and you cover Yahoo and Google at once. The unsubscribe also has to survive the next import, or the same founder gets your third email after asking you to stop. That is the fastest way to turn a quiet campaign into a complaint.
The cleanest fix is sending fewer, better-timed emails
Every rule in this post exists because bulk senders trained inboxes to expect junk. Forty emails to people who asked for what you sell is a different shape of traffic from five thousand to people on a list. We covered the mechanics in the cold email playbook for 2026 and what Gmail says it actually measures in whether Gmail detects AI-written cold email.
Shadow Inbox is our product. It does not send your email or touch your headers. It watches Reddit and Hacker News for people asking for what you sell, so your first message answers something they said, not something you guessed. The header handles the exit. Timing is what keeps people from wanting one.
● FAQ
- Does cold email need a one-click unsubscribe header?
- Google requires it for senders above 5,000 messages a day to Gmail, and only for marketing and subscribed messages. Below that line no Google page we found makes it mandatory. CAN-SPAM does not require a header at all, so the header is a mailbox-provider rule rather than a law.
- Is a footer unsubscribe link enough for Gmail?
- Not for a bulk sender. Google says the one-click requirement needs the List-Unsubscribe and List-Unsubscribe-Post headers, and a visible link in the body is a separate requirement on top. A mailto link in the body alone does not meet it.
- What do the two headers look like?
- RFC 8058 gives the pair as List-Unsubscribe with an HTTPS URL in angle brackets, plus List-Unsubscribe-Post set to List-Unsubscribe=One-Click. The message needs a valid DKIM signature that covers both headers, otherwise receivers should not offer one-click.
- How fast do I have to honour an unsubscribe?
- Yahoo says bulk senders must honor unsubscribes within 2 days, and Google recommends 48 hours. CAN-SPAM allows 10 business days. If you run one suppression list across every tool, you can meet the strictest number and stop thinking about the other two.
- Do I still need the header if I send 40 emails a day?
- No rule we found makes you. We would add it anyway if your tool offers a checkbox, because a recipient with an easy exit has less reason to hit Report spam. That is our reasoning, not a finding from Google.
Three more from the log.

Cold Email Sending Limits: Gmail, Workspace, Outlook
Workspace stops at 2,000 messages a day. Why that cap is not your safe number, and what Google and Microsoft publish about sending volume.
Nov 05, 2026 · 6 min
Cold Email in Australia: What the Spam Act Requires
The Spam Act has no B2B carve-out. What cold email to Australian prospects needs: consent, the work-address exception, a 5-day unsubscribe, and ACMA's penalties.
Oct 29, 2026 · 7 min
Separate Domain for Cold Email: Do You Need One?
Google counts subdomains as one sender, and Postmaster Tools shows nothing at low volume. When a separate cold email domain earns its keep, and when it doesn't.
Oct 06, 2026 · 6 min