---
title: "Adding Custom List-Unsubscribe Headers"
slug: "add-custom-list-unsubscribe-headers"
updated: 2026-01-09T16:04:21Z
published: 2026-01-09T16:34:10Z
canonical: "docs.mapp.com/add-custom-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 Custom List-Unsubscribe Headers

## Goal

Add a custom standard list-unsubscribe header to an email message.

---

## 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.

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.

---

## Procedures

### Managing Unsubscribe Requests in an External Application

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.
5. From the **Setting** drop-down list, select **Header with Custom Values**.
6. In the **Email** field, enter the list-unsubscribe header as a tag. Example: `<mailto:listunsubscribe-listName-externalMessageID-externalUserID@externalDomain.com>`
7. 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>`
8. To insert placeholders for values stored in Mapp Engage, such as user ID or message ID, click **Personalization** and select the required object.
9. Click **Save**.

---

### Managing Unsubscribe Requests in a Separate Group in Mapp Engage

1. Navigate to *Audience > 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.
5. From the **Setting** drop-down list, select **Header with Custom Values**.
6. In the **Email** field, paste the following code: `<mailto:listunsubscribe-<%group.PK%>-<%message.PK%>-<%user.PK%>@<%domain.MailDomain%>>`
7. Replace the placeholder `<%group.PK%>` with the ID of the group that you use to manage unsubscribes.
8. Click **Save**.

## Related

- [List-Unsubscribe Headers](/list-unsubscribe-headers.md)
- [Adding Standard List-Unsubscribe Headers](/add-standard-list-unsubscribe-headers.md)