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.
How to implement email unsubscribe compliance#
- 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-ClickHow to verify it worked#
Send a test message to seed mailboxes at Gmail, Outlook, and Yahoo, then inspect the Authentication-Results and delivery headers. Repeat after any DNS or sending-platform change.
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.