← Glossary

What is List-Unsubscribe / one-click unsubscribe?

A message header that lets mail clients show an unsubscribe button, and the RFC 8058 header that makes it one click.

How it works in practice

List-Unsubscribe holds an https URL and optionally a mailto address. For one-click, List-Unsubscribe-Post must be set to List-Unsubscribe=One-Click, and both headers should be covered by the DKIM signature. Gmail and Yahoo require it on bulk marketing mail.

The common mistake

Adding the headers in the template but not signing them, or pointing at a page that asks for a login.

Check it yourself

Related terms

Not sure whether this is what's hurting your inbox placement? A free deliverability review finds the real cause.

How we help: Consulting · Private infrastructure · Managed mailboxes · Monthly support