Restricted · 2026-11PrimaryGrowth opsOutbound

One-click unsubscribe header on marketing mail

Add a working List-Unsubscribe header so recipients can opt out in one click; required for bulk marketing mail at Gmail and Yahoo.

Claim and evidence

The claimHonor unsubscribes within 2 days

Yahoo · senders.yahooinc.com · undated

What the numbers show

within 2 days

deadline to honour unsubscribes (Yahoo sender requirements, 2024)

senders.yahooinc.com

Why it works

Diagram, not data
Recipient no longerwants the mailOne-click unsubscribein the headerSpam button is theeasiest exitComplaint rate stayslow
Recipient no longer wants themailOne-clickunsubscribe inthe headerSpam button isthe easiestexitComplaint rate stays low

A visible, easy opt-out turns would-be spam complaints into unsubscribes, protecting the sender's complaint rate. Providers now check for the header.

How to run it

  1. Add List-Unsubscribe and one-click POST support in the sending tool
  2. Honor unsubscribes within 2 days
  3. Keep a suppression list shared across tools
  4. Test the header in Gmail and Yahoo

Before / after

Before
This week's update
Opt-out hidden at the bottom
After
Unsubscribe
This week's update
Inbox shows unsubscribe next to the sender

Generalised wireframe of the pattern, not a copy of any company's screen.

Ways to run it

Design options to test, not promised results.

  1. Option AHeader plus footer link

    Support the one-click header and keep a visible footer link for recipients who scroll down.

  2. Option BShared suppression across tools

    Feed unsubscribes from every sending tool into one list so they apply everywhere.

  3. Option CPreference page as a second step

    Unsubscribe immediately on one click, then offer frequency options without making them a hurdle.

Timeline

  1. 12023 first documented: Google Workspace sender guidelines
  2. 22024 Yahoo — Requires a functioning list-unsubscribe header and honoring opt-outs within 2 days.
  3. 32024 Google (Gmail) — Marketing and subscribed messages must support one-click unsubscribe.
  4. 42026-11 status checked: Restricted

Dated examples

  1. 2024

    Yahoo

    Requires a functioning list-unsubscribe header and honoring opt-outs within 2 days.

    “Honor unsubscribes within 2 days”
    ✓ quote checked word-for-word on the page

    senders.yahooinc.com · undated

  2. 2024

    Google (Gmail)

    Marketing and subscribed messages must support one-click unsubscribe.

    “Marketing messages and subscribed messages must support one-click unsubscribe”
    ✓ quote checked word-for-word on the page

    support.google.com · undated

Does it still work?

Restrictedas of 2026-11

Platform rule for bulk senders since Feb 2024; applies to marketing mail, not one-to-one sales mail in the sources' wording. source

Risks

  • Cold outbound blasted at volume can be classed as marketing mail

Sources

  1. senders.yahooinc.com · Yahoo Sender Hub · undated
    “Implement a functioning list-unsubscribe header, which supports one-click unsubscribe”
    ✓ quote checked word-for-word on the page
  2. support.google.com · Google Workspace Admin Help · undated
    “Marketing messages and subscribed messages must support one-click unsubscribe”
    ✓ quote checked word-for-word on the page

Change log

  • 2026-11-20 — harvest v0.1 (acq-outbound)