# The List-Unsubscribe Header, Explained: How to Check and Fix Yours Today

> What the header does, how to see whether your emails carry it, and the steps to add one-click unsubscribe to your cold outreach.

Your cold emails land, a few people reply, and then open rates slowly slide. One common cause sits where you never look: the hidden headers of your messages. If recipients cannot unsubscribe easily, some will hit "Report spam" instead, and those reports hurt every email you send after.

The List-Unsubscribe header is the fix for that. This guide shows you what it is, how to check whether your emails have it, and how to set it up properly today.

## What the header actually does

Every email carries headers: lines of technical information the reader normally does not see, like the sender, date and message ID. List-Unsubscribe is one of them. It tells the mail provider where to send an unsubscribe request.

When Gmail, Yahoo or Apple Mail find it, they can show an "Unsubscribe" link next to your sender name at the top of the email. The recipient clicks it, the provider sends the request for them, and they never have to scroll down to find your footer link.

There are two parts you will see:

- **List-Unsubscribe:** contains a link (https), an email address (mailto), or both. For example: `List-Unsubscribe: <https://example.com/u/abc123>, <mailto:unsub@example.com>`
- **List-Unsubscribe-Post:** contains `List-Unsubscribe=One-Click`. This tells the provider it can unsubscribe the person with a single background request, no landing page or confirmation step needed.

The two together are what people mean by "one-click unsubscribe".

## Why it matters for cold email

The reason is simple: someone who does not want your email will get rid of it somehow. You want that to be an unsubscribe, not a spam complaint.

Google and Yahoo have published sender requirements that ask bulk senders to support one-click unsubscribe and to process requests quickly (they mention within two days). The exact thresholds and who counts as a bulk sender are defined by them, so check their current sender guidelines yourself. Even if your volume is small, following the same standard is a sensible habit.

Laws also come into it. Rules like CAN-SPAM in the US require a working opt-out in commercial email, and other countries have their own rules, some stricter about cold email to begin with. This is not legal advice: check what applies where you and your recipients are.

## Step 1: Check whether your emails have it

This takes two minutes.

1. Send one of your real outreach emails to a personal Gmail address you control.
2. Open it in Gmail on desktop.
3. Click the three dots at the top right of the message and choose **Show original**.
4. Press Ctrl+F (Cmd+F on Mac) and search for `List-Unsubscribe`.

You will find one of three situations:

| What you see | What it means |
|---|---|
| No List-Unsubscribe line | Providers cannot offer an easy unsubscribe. Fix this first. |
| List-Unsubscribe only | Partial support. Add the Post header for one-click. |
| Both headers present | Good. Now test that the link actually works. |

Note that Gmail does not always show the visible Unsubscribe button even when the headers are correct. It decides based on your sending reputation and volume. The headers are still doing their job.

## Step 2: Add it, depending on how you send

**Sending by hand from Gmail or Outlook.** Normal one-to-one emails do not get this header, and you cannot add it from the compose window. If you are only sending a handful of personal emails, a plain line like "Not relevant? Reply 'no' and I won't email again" is honest and workable. Once you send in batches, use a tool that adds the header.

**Using a cold email or campaign tool.** Look in its settings for unsubscribe options and turn them on. Then repeat Step 1 to confirm the header appears. Do not assume: some tools only add it for certain plans or account types.

**Running your own SMTP setup.** You or your developer need to add both headers to each message, with a unique link per recipient. The link should accept a POST request and unsubscribe that person without asking them to log in or confirm. The message should also be DKIM-signed with these headers included, because providers expect that for one-click to be trusted.

## Step 3: Make sure unsubscribes are honored everywhere

The header is only half the job. The other half is never emailing that person again.

- **Suppress across campaigns, not just one.** If someone opts out of your roofers campaign, they should not get your next one either.
- **Stop follow-ups immediately.** A follow-up arriving after an unsubscribe is the fastest way to earn a spam report. If you use [conditional email branching](https://getclient.pro/learn/conditional-email-branching), check that every branch respects the unsubscribe list.
- **Keep the list when you change tools.** Export your suppression list before switching platforms and import it into the new one.
- **Remove before importing.** When you buy, scrape or [find new local businesses](https://getclient.pro/blog/find-new-local-businesses), check new lists against your suppression list before the first send.

## Step 4: Test the full loop

Once a month, run this check:

1. Add a test address to a live campaign.
2. When the email arrives, click the unsubscribe link (header button if shown, otherwise footer).
3. Confirm the address appears as unsubscribed in your tool.
4. Wait for the next scheduled step and confirm nothing arrives.

If any step fails, pause sending until it is fixed.

## Small habits that reduce complaints

The header catches people who want out. These habits mean fewer people want out in the first place:

- Write to one specific business about one specific reason, and keep [one call to action per email](https://getclient.pro/blog/one-call-to-action-per-email).
- Avoid sending to generic inboxes in bulk. Read why in our note on the [role based email](https://getclient.pro/learn/role-based-email).
- Keep a visible footer unsubscribe line too. Not everyone sees the header button.
- Cap daily sends per account so a bad day does not damage your domain.

Get the header right once, test it monthly, and you remove one quiet reason your emails stop reaching inboxes.

## Frequently asked questions

### Does a List-Unsubscribe header hurt cold email deliverability?

No. It gives recipients an alternative to the spam button, and mail providers expect it from people sending in volume. Some senders worry it makes unsubscribing too easy, but an unsubscribe costs you far less than a spam complaint.

### Do I still need an unsubscribe link in the email footer?

Yes, keep both. The header button only appears in some mail apps and not always, while a footer link or opt-out line works everywhere and shows the reader you respect their choice.

### Is a mailto unsubscribe enough on its own?

It is better than nothing, but it is not one-click. A mailto option needs someone to read and process those emails. An https link plus the List-Unsubscribe-Post header lets the provider unsubscribe the person instantly.

### Why doesn't Gmail show the Unsubscribe button on my emails?

Gmail decides when to display it, often based on sender reputation and volume. If Show original confirms the headers are there, they are correct. Focus on testing that the link actually unsubscribes people.

### Can I add a List-Unsubscribe header when sending from plain Gmail?

Not from the normal compose window. You need a sending tool or SMTP setup that adds custom headers. For a few personal one-to-one emails, a clear line inviting a reply to opt out is a reasonable approach.

Source: https://getclient.pro/blog/list-unsubscribe-header-explained