List-Unsubscribe header checker

Paste the headers of an email you sent and see whether mail clients can offer one-click unsubscribe for it. Everything runs in your browser: nothing you paste is sent or stored.

Paste the headers of one message you sent (in Gmail: the three-dot menu, then "Show original"). The body can stay in; only the headers are read.

Short answer

Since February 2024 Gmail and Yahoo require one-click unsubscribe from anyone sending more than 5,000 messages a day to their users. A message qualifies when its List-Unsubscribe header holds an https link, List-Unsubscribe-Post: List-Unsubscribe=One-Click is present, and a valid DKIM signature covers both headers (RFC 8058). The unsubscribe must take effect within two days.

What the checker looks for

  • An https link in List-Unsubscribe. The mail client sends a POST to it when the reader presses Unsubscribe. A mailto address alone is not one-click.
  • List-Unsubscribe-Post with the exact value List-Unsubscribe=One-Click, which tells the receiver the link acts on a POST without a confirmation page.
  • A DKIM signature whose h= list includes both headers, so they cannot be added or changed in transit.
  • A mailto address as well (optional), for clients that only unsubscribe by email.
  • What the receiving server saw: the DKIM, SPF and DMARC results in Authentication-Results, when the headers include them.

Where to find the headers

  • Gmail: open the message, the three-dot menu, then Show original. Copy everything above the message body.
  • Outlook on the web: open the message, the three-dot menu, then View, then View message source.
  • Apple Mail: View, then Message, then Raw Source.

How OutreachPro handles it

Every campaign email OutreachPro sends carries an https one-click link in List-Unsubscribe, plus List-Unsubscribe-Post. Gmail and Microsoft 365 sign the headers with your domain's DKIM key when DKIM is set up for it. Readers who use the link are added to your do-not-contact list immediately.

Learn more