Topic · Compliance

List-Unsubscribe header

The List-Unsubscribe header declares a standardized mechanism recipients or mail clients can use to unsubscribe from mailing lists.

Email Security Glossary·Practical guidance
Share this definition LinkedIn X WhatsApp Email
01 / How it works

How it works

The header can carry HTTPS and mailto destinations and may support one-click handling when paired with the appropriate post header.

02 / What can go wrong

What can go wrong

A decorative unsubscribe link in the email body does not automatically satisfy provider expectations for header-based one-click unsubscribe.

03 / What to check or do

What to check or do

Test the header format, endpoint behavior and suppression timing in a real received promotional message.

Practical diagnosis

How to investigate List-Unsubscribe header

Signal to investigate
A footer link works while mailbox clients cannot detect an unsubscribe method.
Evidence to collect
Check List-Unsubscribe syntax and relevant List-Unsubscribe-Post support in the delivered raw headers.
Common wrong conclusion
A plain-body unsubscribe link will not satisfy header-based interoperability on its own.
Illustrative diagnostic — substitute your authorized domain or host
List-Unsubscribe: <https://example.com/unsubscribe/TOKEN>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Educational example; not validated against your live infrastructure.
NEXT STEP

Put this into practice

Run a focused check, then explore protection if your domain needs it.