Cleanfox

How to find the unsubscribe link in any email (List-Unsubscribe and one-click explained)

Every legitimate newsletter hides its unsubscribe address in two places. Here is how to read them yourself, with no app access required.

Updated 12 Nov 2026 Last verified 12 November 2026
Gmail compose window with an add-on panel highlighting an unsubscribe link option.
Key takeaways
  • 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.

LocationWho reads itTypical form
Footer linkYou“Unsubscribe”, “Manage preferences”, “Opt out”
List-Unsubscribe headerYour mail appA web address and/or an email address
List-Unsubscribe-Post headerYour mail appSignals 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 subject part, if present, tells you what to write.

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

  1. Open the message on a computer.
  2. Click the three-dot More menu next to Reply.
  3. Choose Show original.
  4. Press Ctrl+F (Cmd+F on Mac) and search for List-Unsubscribe.

Outlook.com and the new Outlook

  1. Open the message.
  2. Choose More actions (the three dots), then View, then View message source.
  3. Search for List-Unsubscribe.

Apple Mail

  1. Select the message.
  2. Choose View → Message → Raw Source.

Yahoo Mail

  1. Open the message.
  2. 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.
Spam is different

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:

  1. Scroll to the bottom of the email and look for words like Unsubscribe, Opt out, Manage preferences or Email settings.
  2. In other languages, look for Se désinscrire (French), Abmelden (German), Darse de baja (Spanish), Descadastrar (Portuguese), Disiscriviti (Italian) or Afmelden (Dutch).
  3. Hover over the link and check the address before clicking.
  4. 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:

  1. Export your mail — a single .eml per message, or your whole mailbox as an .mbox file (Gmail uses Google Takeout).
  2. 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.
  3. 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 + httpsInstant, standard unsubscribeUse your mail app's Unsubscribe button
https link onlyOpens a removal pageCheck the domain, then open it
mailto onlyRemoval by emailSend the prepared email
Footer link onlyNo standard headerHover, check, then click
Nothing at allNo way out offeredBlock 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.

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.