One-Click Unsubscribe: Why It Is No Longer Optional and What Setting It Up Involves

Every marketing email has an unsubscribe link in the footer. That has been true for years, and it is a legal requirement in most places. What changed is that the big mailbox providers now also want a second, separate mechanism: a one-click unsubscribe that the mail app itself offers, right next to the sender's name, without the reader ever opening your email or your website.

What one-click unsubscribe actually is

You have probably seen it without knowing what it was: a small "Unsubscribe" link beside the sender in Gmail or Apple Mail. That link is not part of the message body. It is built from two invisible headers your sending system adds to every email:

• List-Unsubscribe: contains a web address (and sometimes a mailto: address) the mail app can use to unsubscribe the person.
• List-Unsubscribe-Post: tells the mail app that it can do this with a single automatic request, with the value List-Unsubscribe=One-Click. This pair is defined in a standard called RFC 8058.

When the reader clicks the mail app's unsubscribe button, the app sends a small request to your address and the person is removed. No landing page, no "are you sure?", no login. That is the point, and it is also why providers like it: it takes the pressure off the spam button.

Who it applies to

Google's and Yahoo's sender rules, which Microsoft later echoed for its consumer mailboxes, require one-click unsubscribe from bulk senders. Google defines a bulk sender as one sending roughly 5,000 or more messages a day to Gmail addresses. The details differ slightly between providers and have been revised over time, so check each provider's current sender guidelines rather than trusting any summary, including this one.

Most small businesses are far below that volume, so the strict requirement may not formally apply to you. There are still two good reasons to have it. First, it is free if your sending platform supports it, and nearly all of them do. Second, a reader who can unsubscribe in one tap does not hit the spam button, and spam complaints are what actually damage a small sender's reputation.

What the rules ask for beyond the header

• Keep the visible footer link too. The header does not replace the link inside the email. Law and good practice both call for a clear, working unsubscribe link in the body.
• Honor requests promptly. Google's guidance for bulk senders is within two days. Treat that as a ceiling and aim for immediately.
• Send from an authenticated domain. The one-click mechanism is expected on mail signed with DKIM, which ties into the SPF, DKIM and DMARC setup covered elsewhere on this blog.
• Do not put obstacles in the way. A one-click request must unsubscribe the person on its own. Asking them to log in or confirm defeats the purpose.

How to set it up

If you send through a mainstream email platform, the honest answer is that you probably already have it. Look in your platform's deliverability or compliance settings for a one-click or List-Unsubscribe option, and leave it on. The platform adds the headers and handles the request for you.

If you send through your own code or a transactional service, you have more to do: add both headers to every marketing message, point the web address at an endpoint that accepts a POST request and unsubscribes that exact recipient (with a token in the link so it cannot be used on someone else), and make the endpoint work without any login. Transactional messages such as receipts and password resets do not need the header and should not carry it.

How to check your own emails

Send yourself a campaign. In Gmail, open it, choose the three dots, then "Show original". Search the raw text for List-Unsubscribe and List-Unsubscribe-Post. If both are there, and the second contains One-Click, you are set. If neither appears, the mail app will not show its unsubscribe button, and it is worth asking your platform why.

None of this is exciting, but it is one of the few deliverability tasks you can finish in an afternoon. Turn it on, check the headers once, and keep your footer link honest. You will lose the people who wanted to leave a little faster, and your complaint rate will thank you.