One-click List-Unsubscribe: what changed with Gmail and Yahoo

Since 2024 bulk senders must offer one-click unsubscribe. Here's how to implement it properly.

What Gmail and Yahoo require

Since 2024 bulk senders must offer one-click unsubscribe and process it within two days. You need the List-Unsubscribe header plus one-click support.

How to implement it

Add two headers to the message:

List-Unsubscribe: <https://yourdomain.com/unsub?u=ABC>, <mailto:unsub@yourdomain.com>
List-Unsubscribe-Post: List-Unsubscribe=One-Click

When the user clicks, the provider sends a POST to your URL: process the unsubscribe without asking for further confirmation.

Common mistakes

• Providing only the mailto: without the HTTPS URL.
• Forgetting the List-Unsubscribe-Post header (without it, it's not one-click).
• Not actually processing the request within 48 hours.