Free tool
List-Unsubscribe header checker
Paste the raw headers of a message to see its unsubscribe links and whether it supports one-click unsubscribe. It runs in your browser, nothing is uploaded, and no link is opened.
What one-click unsubscribe is
RFC 8058 defines one-click unsubscribe with two headers. List-Unsubscribe gives an https URL in angle brackets, and List-Unsubscribe-Post says List-Unsubscribe=One-Click. When a recipient clicks Unsubscribe next to the sender's name, the mail app sends a POST request to that URL and the recipient is removed. There is no page to load and nothing to confirm.
List-Unsubscribe can also carry a mailto: address. Mail apps may use it, but it does not count as one-click.
Gmail and Yahoo require it for bulk mail
Since February 2024, Gmail and Yahoo require one-click unsubscribe on marketing and subscribed mail from bulk senders. Gmail counts you as a bulk sender once you send about 5,000 messages a day to Gmail addresses. Senders must process unsubscribe requests within two days.
A footer link alone is not enough for bulk mail. Keep the link in the message body for people who look for it, and add the two headers so the mail app can show its own Unsubscribe button.
What this checker does and does not do
The checker reads the headers you paste in this page. It lists every URI in List-Unsubscribe, marks which are https and which are mailto:, and checks the exact List-Unsubscribe-Post value. Nothing is uploaded.
It never opens or posts to your unsubscribe URL, so it cannot tell whether the URL works. Test that yourself with a test address. It also cannot see whether the headers are covered by your DKIM signature; check the h= tag of the DKIM-Signature header for list-unsubscribe and list-unsubscribe-post.
Which two headers make an email one-click?
List-Unsubscribe with an https URL in angle brackets, and List-Unsubscribe-Post with the exact value List-Unsubscribe=One-Click. Both must be signed with DKIM.
Is a mailto: address enough?
No. A mailto: address in List-Unsubscribe is still useful, but Gmail and Yahoo require an https URL that accepts the one-click POST request for bulk mail.
Do I need one-click unsubscribe on every email?
No. It is required on marketing and subscribed mail from bulk senders. Transactional messages such as password resets and receipts do not need it.
Does the checker click my unsubscribe link?
No. It only reads the headers you paste, in your browser. It never opens the URL or sends a request to it, so no address is unsubscribed.
Email, newsletters and booking pages on your own domain, in one plan.
Get started for free