The unsubscribe header in the inbox
The unsubscribe button that some mail programs show at the top of a message, next to the sender, does not come from your text but from a technical element in the message: the List-Unsubscribe header. That header gives the mail program an official way to unsubscribe someone with one click, independent of your own unsubscribe link. The large providers now expect it on every commercial mailing, and anyone who leaves it out sees the result in their delivery.
What exactly it is
Every email consists of two parts: the content the reader sees, and a series of headers the mail program reads. The List-Unsubscribe header is one such line, containing a web address or email address to which an unsubscribe request can go. A second header, List-Unsubscribe-Post, makes one-click unsubscribing possible: the mail program then sends the request itself, without the reader landing on a web page. Only when both are present does Gmail or Outlook show that button at the top.
Why you want it
Because the alternative is the spam button. Anyone who wants rid of your mail quickly and only sees "Report as spam" uses that. With providers, a complaint weighs many times more than an unsubscribe: an unsubscribe is a neutral action, a complaint is a vote against you that drags your next send to all recipients at that provider down with it. An easy unsubscribe is therefore not a loss but a release valve.
In concrete terms: a newsletter to ten thousand addresses gets fifteen unsubscribes and two complaints. Those two complaints harm your reputation more than the fifteen unsubscribes put together. Make the unsubscribe more visible and the ratio tips the right way.
What is required
Since early 2024 the largest providers have made the header mandatory for anyone sending large amounts of commercial mail to their users every day, together with correct SPF, DKIM and DMARC records and a complaint rate below a strict threshold. This is not a recommendation: mail that does not comply is delayed or refused. The unsubscribe must also be processed within two days.
How to tell it is missing
Send your newsletter to one of your own addresses at a large provider and open the message. If you see no "Unsubscribe" link next to the sender name, the header is missing or incomplete. Then look in the message's original headers for the lines starting with "List-Unsubscribe". If there is only one, the one-click variant is missing. Many senders assume their platform takes care of it and have never checked.
The mistake that often goes wrong
The button works, but the unsubscribe goes nowhere. The mail program duly sends the request to the address in the header, but that address points to a script that does nothing, or to a mailbox nobody reads, or to an old platform that is no longer connected to your list. The reader believes they have unsubscribed, receives the next newsletter anyway, and then does click spam. Worse than no button at all.
So check not only that the header is present, but that an unsubscribe through that route is actually processed in your list. With a sending platform that happens automatically and you see the unsubscribe in the unsubscribe log straight away; with your own software you have to wire it up yourself. The same goes when your own software sends through the email API: you then keep track of unsubscribes in your own system.
What to check in your platform
- Whether both headers go out with every commercial send. For newsletters via 2Mail that is the default.
- Whether an unsubscribe via the button hits the same list as an unsubscribe via your own link at the bottom.
- Whether transactional mail (confirmations, invoices) does not get the header. There is nothing to unsubscribe from there, and a customer who accidentally unsubscribes from their invoices is a problem you created yourself.
- Whether processing is fast enough. An unsubscribe that is only applied at the next export comes too late.
Test it
Unsubscribe yourself via that button, wait for the next send and check that you receive nothing more. Do it at two different providers, because the button does not behave the same everywhere. Repeat the test after every change of platform or integration. More on how complaints and unsubscribes affect your figures is on the deliverability page.
Frequently asked questions
Does the header replace my own unsubscribe link at the bottom of the mail?
No. Both are needed: the link at the bottom is a legal requirement and works in every mail program, the header is what the large providers demand and what shows the button at the top.
Will I lose more subscribers because of that button?
Slightly more unsubscribes, yes. But those are people who were no longer reading your mail and would otherwise have clicked spam. Your list gets smaller and your delivery gets better.
Does the header belong in B2B mail too?
Yes, as soon as it is commercial or bulk mail. Providers make no distinction between business and private recipients; they look at the kind of message and the volume.
The header is your platform's job; the visible unsubscribe link at the bottom of the email is yours. Where it belongs is covered in the eight parts of a good newsletter template.