The one-sentence version#
Unsubscribe compliance covers the legal and provider requirements for letting recipients opt out: a visible link, one-click List-Unsubscribe headers (RFC 8058), and processing within a defined window.
Why you should care#
Gmail and Yahoo require one-click unsubscribe for bulk senders, and every anti-spam law requires a working opt-out. Easy opt-out also lowers complaints.
The mental model#
Think of email unsubscribe compliance as a contract between you and the mailbox providers receiving your mail. You publish or configure something they can check; they check it on every message; the result feeds their decision about where your message lands. Everything below is about making that check pass consistently.
Your first setup, step by step#
- Include a visible unsubscribe link in every marketing message.
- Add List-Unsubscribe and List-Unsubscribe-Post headers so providers show a native unsubscribe button.
- Process opt-outs immediately; the legal maximum is 10 business days in the US, but providers expect 2 days.
- Never require login or more than one click to unsubscribe.
List-Unsubscribe: <https://example.com/u/abc123>, <mailto:unsub+abc123@example.com>
List-Unsubscribe-Post: List-Unsubscribe=One-ClickWords you will see#
- Mailbox provider: Gmail, Microsoft, Yahoo, Apple, and the corporate gateways that decide where mail lands.
- Authentication: proof that a message is from who it says it is (SPF, DKIM, DMARC).
- Reputation: the provider's running score of your domain and IP.
- Placement: whether a message reaches the inbox, spam, or is rejected.
Common mistakes#
- Unsubscribe pages that ask 'are you sure' with a hidden confirm button.
- Continuing sequences from a different tool after an opt-out in another.
Frequently asked questions#
What is one-click unsubscribe?
An RFC 8058 header pair that lets the mailbox provider send a POST to your endpoint when a user clicks Unsubscribe in the client, with no landing page.