- Newsletters offer two exits: a visible footer link and a hidden List-Unsubscribe header.
- The header is defined by RFC 2369; one-click support is defined by RFC 8058.
- Gmail and Yahoo have required one-click unsubscribe from bulk senders since 2024.
- Always check that a link uses https and points to the brand or a known email service provider.
Two places every newsletter hides its exit
Most people only look at the tiny grey link at the bottom of an email. That link is one exit. The other is invisible in normal view: a line in the message headers that mail apps read to show their own Unsubscribe button. Knowing both makes unsubscribing faster and safer.
| Location | Who reads it | Typical form |
|---|---|---|
| Footer link | You | “Unsubscribe”, “Manage preferences”, “Opt out” |
| List-Unsubscribe header | Your mail app | A web address and/or an email address |
| List-Unsubscribe-Post header | Your mail app | Signals one-click support |
The List-Unsubscribe header
RFC 2369, an internet standard from 1998, defines a header called List-Unsubscribe. It contains one or more addresses inside angle brackets, separated by commas.
List-Unsubscribe: <https://shop.example.com/unsub?id=42>, <mailto:leave@shop.example.com?subject=unsubscribe>
The two kinds of address
- https address: opening it takes you to a page that removes you, often after one confirmation.
- mailto address: sending an email to it asks to be removed. The
subjectpart, if present, tells you what to write.
Why it is safer than the footer
The header is read by your mail app, not by you, and large providers check it against the sender's authentication. A footer link can be anything the sender typed; the header is part of a standard that mailbox providers enforce.
What one-click unsubscribe means
RFC 8058, published in 2017, adds a second header:
List-Unsubscribe-Post: List-Unsubscribe=One-Click
When this line is present and the List-Unsubscribe header contains an https address, a mail app can unsubscribe you with a single background request. You never see a web page, and there is nothing to confirm.
Why it became common
Since 2024, Google's sender guidelines require bulk senders — those sending about 5,000 or more messages a day to Gmail accounts — to support one-click unsubscribe for marketing and subscription mail, and to honour requests within two days. Yahoo introduced similar rules. As a result, most large newsletters now include both headers.
How to view the headers in each mail app
Gmail
- Open the message on a computer.
- Click the three-dot More menu next to Reply.
- Choose Show original.
- Press Ctrl+F (Cmd+F on Mac) and search for
List-Unsubscribe.
Outlook.com and the new Outlook
- Open the message.
- Choose More actions (the three dots), then View, then View message source.
- Search for
List-Unsubscribe.
Apple Mail
- Select the message.
- Choose View → Message → Raw Source.
Yahoo Mail
- Open the message.
- Choose More (three dots), then View raw message.
Thunderbird
Press Ctrl+U (Cmd+U on Mac) to open the message source.
How to read what you find
Example 1: a well-behaved newsletter
From: Weekly Picks <news@shop.example> List-Unsubscribe: <https://shop.example/u/abc>, <mailto:u@shop.example> List-Unsubscribe-Post: List-Unsubscribe=One-Click
One-click support, an https page and an email option, all on the brand's own domain. Your mail app's Unsubscribe button will work instantly.
Example 2: a brand using an email service provider
From: Brand <hello@brand.example> List-Unsubscribe: <https://brand.mailer.example/unsubscribe?u=…>
The link points to the email service provider's domain, not the brand's. That is normal: many brands send through providers such as Mailchimp, Klaviyo, SendGrid or HubSpot, and the unsubscribe page lives there.
Example 3: a warning sign
From: "support@yourbank.example" <alerts@random-mailer.example> List-Unsubscribe: <http://claim-now.example.net/remove>
The display name pretends to be a bank, the real address is unrelated, and the link uses plain http on another unknown domain. Do not click. Report the message as spam or phishing.
A checklist before you click
- The link starts with https.
- The domain matches the brand or a known email service provider.
- The sender's real address (not just the display name) belongs to the brand.
- The page does not ask for your password, card details or a download.
- You remember signing up, or the brand is one you buy from.
If you never subscribed, do not use either link. Clicking can confirm that your address is read. Use Report spam instead.
When there is no header at all
Some smaller senders do not include List-Unsubscribe. In that case:
- Scroll to the bottom of the email and look for words like Unsubscribe, Opt out, Manage preferences or Email settings.
- In other languages, look for Se désinscrire (French), Abmelden (German), Darse de baja (Spanish), Descadastrar (Portuguese), Disiscriviti (Italian) or Afmelden (Dutch).
- Hover over the link and check the address before clicking.
- If there is nothing, block the sender or create a filter.
Doing it for hundreds of emails
Reading headers one by one works for a few senders, but not for a crowded inbox. A faster approach:
- Export your mail — a single .eml per message, or your whole mailbox as an .mbox file (Gmail uses Google Takeout).
- Use a local tool that reads the files in your browser and lists every sender with its header links, one-click support and any warning signs.
- Work through the list, opening only the links you trust.
Because the files are read locally, you never grant an app access to your account.
Understanding the rest of the header block
When you open a message's source to look for List-Unsubscribe, you will see dozens of other lines. A few of them help you judge whether the unsubscribe link deserves your trust.
From and Return-Path
The From line is what your mail app shows as the sender. The Return-Path line shows where bounces go. For newsletters sent through an email service provider, the Return-Path often belongs to that provider. That is normal and not a warning sign by itself.
Authentication results
Most providers add a line called Authentication-Results. Look for spf=pass, dkim=pass and dmarc=pass. When all three pass for the brand's domain, the message almost certainly came from the brand or its provider. If they fail, treat every link in the message with suspicion.
Authentication-Results: mx.example.com; dkim=pass header.d=shop.example; spf=pass smtp.mailfrom=bounce.shop.example; dmarc=pass header.from=shop.example
List-Id
The List-Id line names the mailing list. It is useful when one brand sends several newsletters and you only want to leave one of them.
Precedence and Auto-Submitted
Lines such as Precedence: bulk or Auto-Submitted: auto-generated tell you the message was sent automatically to many people. They confirm you are looking at a newsletter or notification rather than a personal email.
Common email service providers
Many unsubscribe links point to an email service provider's address rather than the brand's own website. That is normal: brands rent these services to send their newsletters, and the provider hosts the unsubscribe page. Common providers include:
- Mailchimp
- Klaviyo
- SendGrid
- HubSpot
- Brevo (formerly Sendinblue)
- Campaign Monitor
- Salesforce Marketing Cloud
- Substack
If the link's address contains one of these providers' names, it is usually a normal brand newsletter. A link on an unknown address that has nothing to do with the brand or a known provider deserves a closer look before you click.
What happens after you unsubscribe
Confirmation pages
An https unsubscribe link usually opens a page that says you have been removed, or asks you to confirm. Some ask which topics you want to keep. You never need to sign in or give extra personal details.
Confirmation emails
Some senders send one final email confirming the removal. That is allowed and is usually the last message you receive.
How long it takes
Under Google's and Yahoo's rules, large senders must process unsubscribe requests within two days. Smaller senders may take longer. In the EU and UK, data-protection and e-privacy rules also require marketing to stop once you object.
Mistakes to avoid
- Clicking unsubscribe in a message you never asked for.
- Trusting the display name instead of the real sender address.
- Entering your password on any page reached from an email.
- Downloading attachments to “confirm” an unsubscribe.
- Forgetting to check that the link starts with https.
Quick reference card
| You see… | It means… | Do this |
|---|---|---|
| One-click header + https | Instant, standard unsubscribe | Use your mail app's Unsubscribe button |
| https link only | Opens a removal page | Check the domain, then open it |
| mailto only | Removal by email | Send the prepared email |
| Footer link only | No standard header | Hover, check, then click |
| Nothing at all | No way out offered | Block or filter |
Frequently asked questions
Why does my mail app sometimes show no Unsubscribe button?
The message may lack a List-Unsubscribe header, the sender may not be trusted yet, or the app may hide the button for mail it considers spam.
Is the mailto option slower?
Often yes, because a person or system has to process the email. The https and one-click options are usually faster.
Can an unsubscribe link infect my computer?
Opening a normal web page from a reputable brand is low risk. Links in spam can lead to phishing pages, which is why you should report spam rather than click.
Do I need to confirm anything after a one-click unsubscribe?
No. That is the point of the standard: the request itself is enough.
Why does the unsubscribe page ask me to pick topics?
Some brands offer a preference centre so you can reduce emails rather than stop all of them. If you want everything to stop, look for an “unsubscribe from all” option.
cleanfox.org is independent and not affiliated with Foxintelligence, NielsenIQ or any mail provider.
