Skip to content
emailrules.today
In forceInboxIn force 1 Jun 2024Verified 2 Aug 2026

Bulk senders must support one-click unsubscribe

What is one-click unsubscribe and is it required?

Global · Tool: Mainstream ESPs (Klaviyo, Mailchimp, Braze, HubSpot, SFMC, and similar)

How email works

In one sentence

Gmail and Yahoo want marketing mail to in one click from the inbox chrome — your usually already does this.

Emailrules interpretation

is the button or inbox control that removes someone without opening a webpage. must support special (List- and List-Unsubscribe-Post). Mainstream add them automatically. You only DIY this if you send outside those tools.

Why it matters. Missing one-click is a bulk-sender fail. If you only send through Klaviyo/Mailchimp/Braze, this is usually already handled — confirm once, then move on.

Dotted words open definitions. See how email actually works.

What to do

Your move — not a lecture

Your ESP already did this

Mainstream platforms do this automatically. You can move on.

This one is done. Klaviyo, Braze, Mailchimp, Salesforce Marketing Cloud and every other mainstream platform add both required to every campaign automatically. If you send through one of them, this was handled for you and you never saw it happen. Anyone telling you to go and implement it has not looked at your account.

Your part: Only if you send from more than one place: the has to reach anything downstream that also emails, like a CRM or a tool on a separate domain.

What to do first

Nothing, if you are on a mainstream . If you send on your own infrastructure, check for both and List--Post, because one without the other does not count.

You can skip this if: You are on a mainstream and it is the only thing that emails your list.

Who this applies to

to Gmail and Yahoo. In practice, everyone.

Checklist

  • 01Verify both are present. A header alone is not one-click and does not satisfy the requirement.
  • 02Process within two days, and make sure your and any downstream systems both receive the suppression.
  • 03Keep the in-body link as well. One-click supplements it, it does not replace it.

That’s enough to act. The exact wording, the enforcement record and every primary source sit under Proof & sources, for counsel, bosses, or AI tools that need a citation. Not legal advice.

Proof

Exact position, enforcement, sources

For records and people who will check you. Skip if Monday’s move is already clear.

Source fact

Gmail and Yahoo require to implement one-click : a List-Unsubscribe header plus List-Unsubscribe-Post, so the mail client can unsubscribe the user with a single POST and no landing page. Yahoo requires the request to be honoured within two days.

What happens if you do not

Enforced through filtering. It is also one of the checks Validity's platform now runs, which tells you how mechanical this has become.

Sources

History of this page

  • Re-verified against primary sources (bulk/auth/consent core).
  • Added.

Related

Take this with you

GET https://emailrules.today/rules/one-click-unsubscribe-rfc-8058?format=json

Same URL, same answer, every field including the ones behind the Proof tab. An Accept: application/json header on the plain URL does the same thing. All the endpoints.