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.