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