What is one-click unsubscribe?

Growth economics & retention

How does one-click unsubscribe work?

A header is a line of hidden information attached to every email. Your sending system adds the two headers. The inbox provider reads them and can show its own unsubscribe control next to your message. The subscriber clicks once, and the inbox sends the request to your web address in the background. The standard forbids cookies or logins in that request and forbids redirecting it to another page1.

There is a technical catch. RFC 8058 requires a valid DKIM signature (a cryptographic stamp showing the email really came from your domain) that covers both headers; without it, inbox providers should not offer the one-click option1.

Your system then has to remove that address from marketing sends. That part is yours. The header only carries the request. Yahoo gives senders 2 days to honour an unsubscribe3.

Why does it matter for ecommerce brands?

The alternative to leaving politely is the spam button. When recipients cannot find the exit, some mark the message as spam instead. That hurts email deliverability, which is whether your email reaches the inbox at all. It also pushes up your spam complaint rate, the share of delivered messages that recipients mark as spam.

For the full list of what Gmail and Yahoo expect from senders, see Gmail Yahoo bulk sender requirements. For the money side of email, see customer retention strategy ecommerce.

For ZFD: We treat an unsubscribe as a cleaner list, and we judge email by margin, not by list size.

Easily confused with

  • One-click unsubscribe vs Email deliverability

    The outcome. One-click unsubscribe is one of the things that protects it.

  • One-click unsubscribe vs DMARC

    A different rule. It checks who is allowed to send as your domain. One-click unsubscribe is about how people leave.

  • One-click unsubscribe vs Preference centre

    A page where subscribers choose what to receive. Useful, but it is not one click.

FAQ

A rider in a red cape and bicorne hat on a rearing yellow plush horse, after David's Napoleon Crossing the Alps

Is one-click unsubscribe required by Gmail and Yahoo?

Gmail requires it on marketing and subscribed messages from senders of more than 5,000 messages a day2. Yahoo requires it on promotional and marketing messages and points to RFC 8058 as the preferred method3.

Do I still need a visible unsubscribe link?

For Gmail's larger senders, yes: the guidelines ask for a clearly visible link in the message body as well2. Keep both.

Does one-click unsubscribe delete the subscriber?

No. It sends a request to your system. What happens next, such as suppressing the address from marketing sends, depends on how your email tool is set up.

Let’s find what’s actually working.

Next step. Email problems rarely fix themselves. See our retention and CRM service.