Introduction to the List-Unsubscribe header

The List-Unsubscribe header is an optional header that can be included in email messages. It provides a way for email recipients to easily unsubscribe from a mailing list or service. By including this header, email clients can offer a one-click unsubscribe feature to their users.

Syntax

The List-Unsubscribe header has the following syntax:

List-Unsubscribe: <unsubscribe-URL>

The <unsubscribe-URL> is the URL that the user will be directed to when they click the unsubscribe link. This URL should point to a webpage or an automated process that handles the unsubscribe request.

Usage

Including the List-Unsubscribe header in an email message allows the recipient to easily unsubscribe from the mailing list or service. When supported by the email client, it can provide a more user-friendly experience for managing email subscriptions.

To include the List-Unsubscribe header in your email message, you can use the following code snippet:

List-Unsubscribe: <unsubscribe-URL>

Replace <unsubscribe-URL> with the actual URL where users can unsubscribe. It is recommended to provide both a URL and an email address for unsubscribing, as some email clients may not support clickable URLs.

Example

Here is an example of how the List-Unsubscribe header can be used:

From: example@example.com
To: recipient@example.com
Subject: Your message

List-Unsubscribe: <https://example.com/unsubscribe>

Hello,

This is the content of your email message. Please click the following link to unsubscribe from our mailing list: [Unsubscribe](https://example.com/unsubscribe).

Thank you.

Note the use of the List-Unsubscribe header followed by the actual unsubscribe URL in the email message.

Including the List-Unsubscribe header in your email messages can improve the user experience by providing an easy way for recipients to unsubscribe from your mailing list or service.