Free 7-step checklist and PDF
One-click unsubscribe: does yours meet the Gmail and Yahoo rule?
For: anyone who sends marketing email and wants to know their unsubscribe passes. A developer asked to "add one-click", a marketer who read about the rule, or a sender whose spam reports went up.
- The seven checks, open on this page, no sign-up needed to read them.
- Tick each step as you go. Your ticks stay in this browser.
- Your ticks and your row as a PDF, with room to note what your tool sends.

The 60-second answer
Two headers on every marketing email:
List-Unsubscribewith an https link, andList-Unsubscribe-Post: List-Unsubscribe=One-Click. Gmail and Yahoo require both from bulk senders.One tap and done. The inbox sends a request to your link, and you remove the person with no page, no login and no "are you sure". Gmail and Yahoo expect it honored within two days.
Keep the link in your footer too. The header adds to it and never replaces it.
Every explanation on this page comes from the Email Almanac, our own library of more than 4,000 answers about email. You do not have to buy anything to read it.
- You get one email.It comes from Review My Emails, with the PDF link inside.
- Your PDF opens with your ticks.Every step you ticked is marked on it.
- Nothing else, unless you ask.No newsletter unless you tick the box. Unsubscribe in one click, any time.
The guide
The check, in 7 steps
One line each. Tick them as you go. Open a step for the full explanation.
- 1
Why:if only
List-Unsubscribeis there, you do not meet the one-click rule.Read the full explanation
Send a test to a Gmail address you own, open it and choose Show original. Look for two lines:
List-UnsubscribeandList-Unsubscribe-Post. If only the first is there, you do not meet the one-click rule. A mailto address on its own is the older method. Gmail and Yahoo ask for the https link, and the best practice is both in one header. The rule covers domains that send 5,000 or more emails a day to Gmail, counted across everything the domain sends. Transactional mail such as receipts and password resets is exempt. - 2
Why:a shared link that does not know who clicked will not work.
Read the full explanation
The link in the header must carry a token that says exactly who is leaving. A shared link that does not know who clicked will not work. Your email marketing tool should make these tokens for you.
- 3
Why:if your link answers anything but 200, the unsubscribe fails silently.
Read the full explanation
When someone taps unsubscribe in Gmail or Yahoo, the inbox itself sends a POST to your link carrying
List-Unsubscribe=One-Click. Your server reads the token, removes the person and answers 200. No redirect, no form, no "are you sure" page. If it answers anything else, or the link does not exist, the unsubscribe fails silently. The person stays on your list and may report you as spam instead. Handle a plain visit to the same link too, for people who click it inside the email. - 4
Why:Gmail and Yahoo expect a request honored within two days. Best practice is at once.
Read the full explanation
Gmail and Yahoo expect a request honored within two days, and they check by watching whether later sends still reach that person. Best practice is at once: add the address to your global suppression list, cancel queued campaigns, stop running automations, and block it from coming back in a CRM import. The laws set slower outer limits, such as 10 business days under CAN-SPAM, and that is a ceiling, not a target.
- 5
Why:many email clients never show the header's button.
Read the full explanation
The header adds to the unsubscribe link in your email, it does not replace it. Many email clients never show the header's button, and CAN-SPAM still asks for a clear opt-out inside the email. Put it where people expect it, readable, in plain words. "Unsubscribe" beats "manage preferences". It should work on the first click, not lead to a form.
- 6
Why:ask why someone is leaving only after the unsubscribe has gone through.
Read the full explanation
A preference center can offer fewer emails, chosen topics or a pause, with the unsubscribe from everything just as easy to see. Offer only the choices you will really honor. You may ask why someone is leaving, but only after the unsubscribe has gone through, and answering stays optional.
- 7
Why:unsubscribe a test address mid-automation and check the next email drops.
Read the full explanation
Unsubscribe a test address in the middle of an automation and check that the next scheduled email to it drops. If your header also carries a mailto address, check that its inbox takes mail and that your tool really processes what lands there.
See every row of the table
What your ticks mean
| Where you are | Do this first |
|---|---|
| No one-click header yet, and you send 5,000 or more a day to Gmail | This is the gap Gmail and Yahoo check. Switch on one-click in your email marketing tool, or add both headers yourself. A mailto address alone does not meet the rule |
| No one-click header yet, and you send less, or you are not sure | Add it anyway. Every commercial email needs a working way out, and the header gives people who want out a one-click exit, so fewer reach for the spam button. The 5,000 counts everything your domain sends |
| The header is there, but the link is shared or the endpoint is untested | Fix the endpoint first. A shared link cannot tell who is leaving, and an endpoint that does not answer 200 fails silently, so the person stays on your list and may report you as spam |
| Removal takes more than two days, or misses your automations | Remove at once from every list, queue and automation, and block re-adds from imports. Gmail and Yahoo check that mail stops within two days |
| No visible unsubscribe link in the email | Put it back in the footer. The header does not replace it, and many email clients never show the header's button |
| The rule is met, the extras are not | Offer less mail before goodbye, with the full unsubscribe just as easy to find. Then unsubscribe a test address mid-automation and check the next email drops it |
| All seven ticked | You meet the one-click rule as the Almanac sets it out. Watch your unsubscribe rate: under 0.5 percent a campaign is healthy, and above 1 percent is a problem to look into |
See how it plays out for a real business
Worked example. Morwenna Deep writes the weekly newsletter for Anchor & Oar Books from news@anchor-oar.example, and on sale days it goes to more than 5,000 Gmail readers. Morwenna sends a test to a Gmail address Morwenna owns and opens Show original. List-Unsubscribe is there, but it holds only a mailto address, and List-Unsubscribe-Post is missing. That is row a: the older method on its own does not meet the rule. Morwenna switches on one-click in the email marketing tool, sends another test, and pastes the headers into the free email header analyzer. Both lines are there now. Last, Morwenna unsubscribes wren@mailbox.example halfway through the welcome series and checks that the next email in the series drops it. The next week, a reader called Una Subscribe taps unsubscribe at the top of Gmail, and the next newsletter no longer goes to Una.
Who we are
About Review My Emails
Review My Emails is email list cleaning and validation that tells you which addresses to keep, which to watch and which to stop sending to, and why.
Most checkers answer one question: does this address exist? We answer the next one: should you send to it? An address can be perfectly valid and still be quietly damaging your sender reputation. Valid is not safe.
The company was founded in 2020 and is based in Bolton, United Kingdom. Our founder is Yanna-Torry Aspraki, an email deliverability specialist who has worked in deliverability since 2015.
Your next step. Check your own headers with the free email header analyzer at reviewmyemails.com/tools/email-headers. Paste the headers of a test send and look for both lines. Built it yourself and it still fails, or not sure what your email marketing tool sends? Ask the free SOS line at reviewmyemails.com/sos. A real person answers, with no pitch.
List cleaning does not fix SPF, DMARC, MX or blocklist problems. Those live in your sending setup, and they are a different job. A blocklist listing measures your sending, so it is never a reason to suppress anyone on your list. And nobody can promise you the inbox, so we do not.
Yanna-Torry Aspraki, Review My Emails
Email SOS Hotline, free
Stuck? We are here.
For those problems there is the Email SOS Hotline, our free help line. Tell Yanna-Torry what is going on and she will tell you what she would do. She reads every message herself and replies within 48 to 72 hours, with no pitch.
Ask the free SOS lineWords used
- List-Unsubscribe header
- a line in the email's headers that tells the inbox how to unsubscribe someone without opening the message
- One-click unsubscribe (RFC 8058)
- the standard that adds
List-Unsubscribe-Post, so the inbox can remove someone with a single request - Bulk sender
- a domain sending 5,000 or more emails a day to Gmail addresses
- Suppression list
- the addresses your sending system will never contact, even if they turn up in a new import
- Preference center
- a page where subscribers choose which emails they get and how often
- Unsubscribe and spam report
- an unsubscribe stays between you and the reader. A spam report goes to their mailbox provider and counts against your domain
Where this came from: the Review My Emails Email Almanac.
- What is a good unsubscribe rate?
- What is the difference between unsubscribe and complaint?
- How do list-unsubscribe headers affect complaint rates?
- How to design preference centers for compliance (opt-down vs opt-out)?
- How quickly must unsubscribe requests be honored under CAN-SPAM?
- What are the legal requirements for unsubscribe links?
- How must unsubscribe requests be processed (timing, confirmation)?
- Should the unsubscribe process be one-click?
- Where should the unsubscribe link be placed?
- Can I ask for feedback during the unsubscribe process?
- What is a suppression list?
- How to handle bounced unsubscribes?
- What is an email preference center?
- What options should a preference center offer? (e.g., frequency, content types)
- What is the List-Unsubscribe header?
- What's the difference between mailto: and http: List-Unsubscribe?
- How to prevent accidental resends after unsubscribes?
- Who do these requirements apply to? (Bulk senders definition)
- What are the requirements for easy unsubscribe?
- How do I check if I'm compliant?
- What is RFC 8058?
- How does one-click unsubscribe work technically? (List-Unsubscribe header)
- Is one-click unsubscribe required by Gmail/Yahoo?
- How do I implement the List-Unsubscribe header correctly?
- Does this replace the unsubscribe link in the email body?
- How do MBPs verify unsubscribe compliance?
Founded in 2020, based in Bolton, United Kingdom.
reviewmyemails.com/resources/one-click-unsubscribe?c=web-p10-r08pdf · v1.1