One-click unsubscribe
Inbox apps can unsubscribe someone with one click using special email headers — no landing page required.
Say it out loud
“Gmail's own unsubscribe button. Our platform adds it, and it has to be two headers, not one.”
Gmail and Yahoo require bulk senders to support RFC 8058 one-click unsubscribe: a `List-Unsubscribe` header and a `List-Unsubscribe-Post` header. The mail app posts once and the person is out, with no landing page and no confirmation step. Mainstream platforms add both automatically on marketing sends.
- 2 days
- to process an unsubscribe
- Google and Yahoo sender guidelines
This header has existed since 1998. On its own it is not one-click and never was.
This is the line that makes it RFC 8058. It is the one that is missing when a checker says you fail.
Half of RFC 8058 is not RFC 8058. If you only see the first header, the mail app will not show its own unsubscribe button.
Your platform
Klaviyo, Mailchimp and friends do this automatically.
What goes wrong
A custom sending setup, or a transactional stream repurposed for marketing, that ships the first header and not the second. Your platform adds both to campaigns; it does not necessarily add them to whatever you built yourself.
Check it yourself
Paste a received message's headers and look for both lines
Run it now →The dated rules behind this
A definition is not a citation. These are the pages with the primary source, the date it was published, and what to do about it.
See also
Where this sits
Stop 2, you build the message. You choose a From address, write a subject line, and add the things the law requires to be in the message.