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.
- Send one of your real outreach emails to a personal Gmail address you control.
- Open it in Gmail on desktop.
- Click the three dots at the top right of the message and choose Show original.
- 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.
In GetClient, campaigns sent from your connected Gmail or SMTP accounts include a one-click unsubscribe link with a signed URL unique to each recipient, and anyone who unsubscribes is skipped automatically in later sends and follow-ups.
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, 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, check new lists against your suppression list before the first send.
Step 4: Test the full loop
Once a month, run this check:
- Add a test address to a live campaign.
- When the email arrives, click the unsubscribe link (header button if shown, otherwise footer).
- Confirm the address appears as unsubscribed in your tool.
- 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.
- Avoid sending to generic inboxes in bulk. Read why in our note on the 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.