What are the requirements for easy unsubscribe?

If someone wants off your list, they should be able to leave in one click. That's the spirit behind the easy unsubscribe rules that Gmail and Yahoo Mail made official for bulk senders in 2024. And honestly, it's a standard worth holding yourself to even if you're not yet in the bulk sender category.

There are two parts to getting this right, and you need both of them.

Part one: the List-Unsubscribe header. This is a line of code in your email's technical header (not the visible body). When it's present, Gmail and Yahoo display an unsubscribe button right in their own interface, at the top of the message. Your ESP almost certainly adds this for you, but it's worth confirming. The key piece is the List-Unsubscribe-Post header, which tells the mailbox provider to process the unsubscribe via a POST request automatically. That's the "one-click" part. No login page, no confirmation form, no friction.

Part two: a visible unsubscribe link in the email body. The header handles the inbox-level button, but you still need a real unsubscribe link that anyone can find inside the email itself. This is a CAN-SPAM requirement and a basic courtesy. It can't be hidden in size-4 font or buried in seven paragraphs of legal text. It needs to be findable.

One more thing to know: once someone unsubscribes, you have two days to honor it. Not two weeks. Two days. Processing it slowly (or not at all) is one of the fastest ways to damage your sender reputation and push your complaint rate in the wrong direction. People who can't unsubscribe start hitting the spam button instead.

Want to check if your headers are set up correctly? Run a test send and view the raw headers in our free Email Header Analyzer. You'll see exactly what's being passed to the mailbox provider.