How List-Unsubscribe helps email deliverability

Modified on: Tue, 30 Jun, 2026 at 3:39 AM

Email Deliverability
List-Unsubscribe Header
How the list-unsubscribe header works, why it protects your sending reputation, and what to do if it isn't showing up.
Overview

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.

1

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).

Example of the list-unsubscribe header displayed in an email client
The "Unsubscribe" option appears directly in the email header, surfaced by the recipient's email client.
2

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.

By enabling a clean unsubscribe path, you reduce spam complaints, protect your sender score, and maintain higher deliverability rates over time.

Pro Tip

Every unsubscribe via the header is one fewer spam complaint. Keeping your complaint rate low is one of the most reliable ways to protect long-term inbox placement.

3

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.

Note

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.

4

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.

What this means for you
You need to build sender reputation first

Inbox providers are deliberately conservative when deciding which senders to trust. As your reputation grows — through good list hygiene, low complaint rates, and consistent sending practices — the header-level unsubscribe option will begin to appear for your recipients.

Tip

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.

5

Frequently Asked Questions

Q: Does the list-unsubscribe header replace the unsubscribe link in my email body?
No. The header-level unsubscribe is an additional option — it doesn't replace the unsubscribe link inside your email. You should keep your in-body opt-out link as well, both for compliance and for recipients using email clients that don't surface the header option.
Q: Will contacts who unsubscribe via the header be removed from my list automatically?
Yes. When a recipient uses the header-level unsubscribe option, the opt-out is processed and their contact record is updated automatically. They will no longer receive marketing emails from you.
Q: Is the list-unsubscribe header required by law?
While the header itself is an industry standard (RFC 2369 / RFC 8058) rather than a legal mandate, providing a functional unsubscribe mechanism is required under laws like CAN-SPAM (US), CASL (Canada), and GDPR (EU). The header supports compliance but doesn't replace the legal obligation to include a working opt-out link in your emails.
Q: Which email clients show the list-unsubscribe option?
Gmail and Outlook are the most common clients that surface this option. Apple Mail also supports it in some configurations. Coverage continues to expand as inbox providers adopt the standard more broadly — but display always depends on whether the provider trusts your sender reputation.
Q: How long does it take for the header unsubscribe option to start appearing?
There is no set timeframe — it depends on inbox providers recognizing your domain and IP as trustworthy. Senders with good authentication (SPF, DKIM, DMARC), consistent sending patterns, low bounce rates, and minimal spam complaints tend to gain this trust faster. It can range from a few weeks to a few months of consistent, healthy sending.
Q: Does using the list-unsubscribe header affect my deliverability metrics?
Positively, yes. Contacts who use the header to unsubscribe are not counted as spam complaints — they're clean opt-outs. This keeps your complaint rate low, which is one of the primary signals inbox providers use to evaluate sender trustworthiness and determine inbox vs. spam folder placement.
Q: Can I see who unsubscribed via the header vs. via the in-email link?
Both opt-out methods update the contact's subscription status in the platform. The distinction between the source of the unsubscribe (header vs. in-body link) may not always be surfaced in reporting, but the resulting contact status change is the same either way.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article