Tradehub International Ltd

List-Unsubscribe header is vital for email deliverability

What is a List-Unsubscribe header?

When subscribers want to unsubscribe from a mailing list and the unsubscribe process is too complex, subscribers will often use the SPAM button to unsubscribe from the mailing list. And using this SPAM button, will directly negatively impact sender reputation, thus lowering email delivery. That is, unless List-Unsubscribe is used. This feature gives an additional way to unsubscribe and the number of times the SPAM button gets hit will be reduced. In GMAIL the List-Unsubscribe feature will be visualised for users as: In the next two paragraphs we will explain the best practice set-up of the List-Unsubscribe header and will share a case study on the situation before and after a List-Unsubscribe header implementation with mailto:link.

Best practice set-up of the List-Unsubscribe header

The List-Unsubscribe is an additional header inserted by email applications. It provides two mechanisms for ISPs to unsubscribe the recipient from a mailing list:  
by following a http:// link, or
by mailto:link in the email.
The List-Unsubscribe is a standard header and is defined in RFC 2369.
The List-Unsubscribe header formatting is:
List-Unsubscribe: <mailto:[email protected]>,</mailto:[email protected]>
Please note that the unsubscribe link (http:// link ) should not require further input from the user and the request should be processed after receiving a POST request. It should be one-click unsubscribe as described in RFC 8058 below :
List-Unsubscribe-Post: List-Unsubscribe=One-Click
Resulting POST request
POST /unsubscribe/opaquepart HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: 26
Also, the local part of mailto:link address should not exceed more than 64 characters.

The importance of mailto:link!

Hotmail only supports the mailto:link. When a user clicks on the ‘unsubscribe’ option in Hotmail, Hotmail tries to read the mailto:link in the List-Unsubscribe header. If the mailto:link is missing, it moves all the messages to the Junk folder. All further emails from the same sender will be pre-routed to the Junk folder without notifying the sender through a JMRP complaint. For more information, please read Hotmail Email Sender Guidelines. Gmail supports both the http:// link and the mailto:link. But when a Gmail user reports email as ‘SPAM’, Gmail will try to unsubscribe by sending empty message to the address in List-Unsubscribe (mailto:). Thereafter, it is more likely to put all new emails from that sender in the SPAM folder. For more information, please read Gmail Email Sender Guidelines. The mailto:link is supported by Gmail, Hotmail, Yahoo, AOL, ATT, Time Warner and Comcast; European ISPs such as GMX, Libero, Ziggo, Orange, BTInternet; Russian ISPs such as and Yandex; and the Chinese domains, etc. So most ISPs support (and prefer) mailto:link.

Case study: the effect of implementing a mailto:link

One of CSE’s clients implemented a List-Unsubscribe header, but without a mailto:link. As soon as the mailto:link was added, the MTA received 55,000 unsubscribe requests via the mailto:link in 30 days (150 million emails were delivered during this period, but it is still a significant number of unsubscribers). Of these:  
20,000 unsubscribe requests were received from (not including GSuite domains),
14,000 were from Yahoo related domains,
3,500 were from Hotmail related domains,
3,500 were from Apple domains such as etc.,
the remaining were from other ISPs.
Special PowerMTA add-on to process unsubmails
CSE built a Webhook programme called ‘unsubmail’ which is spawned by PowerMTA. It receives emails from the PowerMTA pipe queue and converts them into a calling URL by mapping parameters from the local part of mailto:link to http://URL.
Written by


  • Alina Kelian January 30, 2022

    Here are just a few things to know about online payment systems. … A merchant account is a bank account that allows.

  • Jennie Hadid January 30, 2022

    Here are just a few things to know about online payment systems. … A merchant account is a bank account that allows

Leave a comment