Adaptive AI Knowledge Base
Email Setup & Deliverability
The list-unsubscribe header is a standard email feature that lets recipients opt out directly from their inbox — without hunting for a link inside your email. Major email providers like Gmail and Outlook surface this as a visible "Unsubscribe" button in the message header.
This article explains what the header is, why it benefits your deliverability, whether it can be turned off, and why some senders don't see it displayed.
What is the list-unsubscribe header?
The list-unsubscribe header is an additional "Unsubscribe" link generated by common email providers such as Gmail and Outlook. When the header is detected in an outgoing email, the recipient's inbox surfaces a prominent unsubscribe option — without them needing to scroll through the message body to find your opt-out link.
This creates a seamless, one-click experience that benefits both the sender (fewer spam complaints) and the recipient (easy control over their inbox).
Why it's good for email deliverability
The list-unsubscribe header is a deliverability best practice. When a subscriber wants to stop receiving your emails, this header gives them a safe, easy exit. Without it, frustrated recipients are more likely to hit Report Spam — which damages your sending reputation and can impact inbox placement for your entire list.
Can this be disabled? No. The list-unsubscribe header cannot be disabled. It is an RFC and industry standard, meaning it is baked into how email infrastructure operates — not an optional feature inside the platform.
This is intentional — not a limitation. The header exists to protect both senders and recipients, and its inclusion is increasingly required by major inbox providers like Gmail and Yahoo.
Why I'm not seeing the unsubscribe option in the header
The unsubscribe option is only displayed for senders with a sufficiently high sending reputation. Email providers like Gmail and Outlook make a trust-based decision — they only surface the header-level unsubscribe link when they are confident the sender will actually honor the request.
For senders identified as potential spammers, inbox providers will not display the option at all. This is by design — a visible unsubscribe link from an untrustworthy sender could be used to confirm active addresses and lead to more spam, not less.
To build reputation faster: send only to engaged subscribers, remove hard bounces promptly, honor unsubscribe requests immediately, and avoid sudden large volume spikes. Consistent, permission-based sending is the most reliable path to inbox trust.