---
title: "Adding List-Unsubscribe Headers"
slug: "engage-adding-list-unsubscribe-headers"
status: "new"
updated: 2026-07-30T07:56:16Z
published: 2026-07-30T07:56:16Z
canonical: "docs.mapp.com/engage-adding-list-unsubscribe-headers"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding List-Unsubscribe Headers

## Goal

Add a standard or custom list-unsubscribe header to a group's sendouts.

---

## Background Information

In most ISPs, the list-unsubscribe header enables the inclusion of an unsubscribe link or button in the web interface of an email client. This makes it easier for recipients to unsubscribe and reduces the likelihood that they mark the message as spam or block the sender.

Using headers with standard values ensures that unsubscribe requests are handled correctly within the group in Mapp Engage. Alternatively, you can add a list-unsubscribe header with custom values to manage unsubscribe requests either outside of Mapp Engage or within a separate group in Mapp Engage. The option you choose depends on how you handle unsubscribe requests.

---

## Procedure

To add a list-unsubscribe header, first open the group's sendout options:

1. Navigate to *Audience > Group Management > Groups*.
2. In the **Action** column, click the icon next to the group.
3. Click the **Sendout Options** tab.
4. Expand the **List-Unsubscribe Header** area.

Then, from the **Setting** drop-down list, select the value you need, as described in the following sections.

### Standard value

1. From the **Setting** drop-down list, select **Header with Standard Value (unsubscribes are handled by Mapp Engage)**.
2. Click **Save**.

After saving, a list-unsubscribe header with standard values is added to every message sent to group members. Both email-based and web-based headers are added automatically.

### Custom values

From the **Setting** drop-down list, select **Header with Custom Values**. The values you then enter depend on how you handle unsubscribe requests.

#### Managing unsubscribe requests in an external application

1. In the **Email** field, enter the list-unsubscribe header as a tag. Example: `<mailto:listunsubscribe-listName-externalMessageID-externalUserID@externalDomain.com>`
2. In the **Web** field, enter the list-unsubscribe header as a tag. The web header supports both HTTP and HTTPS. Example: `<http://externalDomain.com/member/unsubscribe/?listName=listname@externalDomain.com&mid=externalMessageID&id=externalUserID>`
3. To insert placeholders for values stored in Mapp Engage, such as user ID or message ID, click **Personalization** and select the required object.
4. Click **Save**.

#### Managing unsubscribe requests in a separate group in Mapp Engage

1. In the **Email** field, paste the following code: `<mailto:listunsubscribe-<%group.PK%>-<%message.PK%>-<%user.PK%>@<%domain.MailDomain%>>`
2. Replace the placeholder `<%group.PK%>` with the ID of the group that you use to manage unsubscribes.
3. Click **Save**.