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.

Email me my filled-in checklist

The cover of the PDF
PDF, 35 pages

The 60-second answer

  1. Two headers on every marketing email: List-Unsubscribe with an https link, and List-Unsubscribe-Post: List-Unsubscribe=One-Click. Gmail and Yahoo require both from bulk senders.

  2. 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.

  3. 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.

Free PDF, 35 pages

Take your filled-in checklist with you.

Your ticks and your row of the table, as a PDF.

We send the PDF to this address and nothing else unless you tick the box. Unsubscribe in one click, any time.
  1. You get one email.It comes from Review My Emails, with the PDF link inside.
  2. Your PDF opens with your ticks.Every step you ticked is marked on it.
  3. 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.

0 of 7 done
  1. 1

    Why:if only List-Unsubscribe is there, you do not meet the one-click rule.

    Read your headers

    Read the full explanation

    Send a test to a Gmail address you own, open it and choose Show original. Look for two lines: List-Unsubscribe and List-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. 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. 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. 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. 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. 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. 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 areDo this first
No one-click header yet, and you send 5,000 or more a day to GmailThis 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 sureAdd 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 untestedFix 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 automationsRemove 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 emailPut 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 notOffer 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 tickedYou 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 line
The cover of the PDF

Free PDF, 35 pages

Want this as a PDF?

Your ticks and your row, with room to note what your tool sends.

We send the PDF to this address and nothing else unless you tick the box. Unsubscribe in one click, any time.
Words 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.
Review My EmailsTrust beats tactics™

Founded in 2020, based in Bolton, United Kingdom.

reviewmyemails.com/resources/one-click-unsubscribe?c=web-p10-r08pdf · v1.1

Spotted something out of date?