# List-Unsubscribe: the header behind the unsubscribe button List-Unsubscribe is the email header that puts an unsubscribe button in Gmail and other inboxes. How it works, one-click unsubscribe, and how Mimeo sets it. **Definition:** List-Unsubscribe is an email header that tells the inbox how to unsubscribe the reader, so Gmail, Yahoo and Apple Mail can show their own unsubscribe button next to the sender. ## How it works The header sits in the email's headers, not in its body. It holds a way to unsubscribe: a web address, an email address, or both. A second header, `List-Unsubscribe-Post`, makes it **one-click** (RFC 8058): the inbox sends a single POST request to the web address and the person is unsubscribed, with no page to visit. ``` List-Unsubscribe: List-Unsubscribe-Post: List-Unsubscribe=One-Click ``` Both halves matter. Without `List-Unsubscribe-Post`, a mail client shows a link rather than its own unsubscribe button. Gmail requires one-click unsubscribe on marketing email from anyone who sends more than 5,000 messages a day. ## Why it matters - **Fewer spam complaints.** A reader who can unsubscribe in one tap doesn't need the spam button. - **Inbox placement.** For bulk senders, Gmail's sender guidelines make one-click unsubscribe a requirement, not a nice-to-have. - **It has to work at once.** The unsubscribe should take effect straight away, so the next email never reaches the person. ## How Mimeo handles it Mimeo sets both headers on every broadcast and sequence send, pointing at your own Mimeo. (Postmark's broadcast streams replace them with Postmark's own until you turn on custom unsubscribe handling; see [Postmark setup](https://mimeohq.com/docs/providers/postmark).) When a mail client uses the button, Mimeo handles the request itself: a valid token always unsubscribes the person from everything, and the unsubscribe is recorded against the exact email it came from. See [one-click unsubscribe](https://mimeohq.com/docs/api/subscriptions#one-click) in the API docs, and [Mimeo terms](https://mimeohq.com/docs/glossary) for unsubscribes and suppression in Mimeo's own words. ## Sources 1. [Email sender guidelines](https://support.google.com/a/answer/81126), checked 2026-11-09 2. [Subscriptions API](https://mimeohq.com/docs/api/subscriptions), checked 2026-11-09 --- This is the Markdown copy of https://mimeohq.com/glossary/list-unsubscribe.