Create and Manage Unsubscribe Groups

To create an Unsubscribe Group:

1. Select Marketing and then click Unsubscribe Groups.
2. Click Create New Group.
3. Add a Group Name and Group Description.

4. Select the checkbox if you want the Unsubscribe Group to display on the unsubscribe preferences page.
5. Click Save Unsubscribe Group.

Using the Design Editor:

1. Select your preferred Unsubscribe Group by clicking Settings and selecting the group from Recipients.
2. From the Build tab, drag the Unsubscribe module to insert Sender Information and a link to the {{{unsubscribe}}} tag.
3. To manually hyperlink to the {{{unsubscribe}}} tag, enter the text you would like to link.
4. Highlight the text then select the link icon from the top toolbar.
5. In the URL field enter {{{unsubscribe}}}, then click Save.

Using the Code Editor:

1. Select your preferred Unsubscribe Group by navigating to Settings and then selecting Recipients.
2. Enter the following code styling to the HTML window where you would like your unsubscribe content placed:

<a href="{{{unsubscribe}}}">Click here to unsubscribe.</a>

While Twilio SendGrid Unsubscribe Groups are a powerful way to manage unsubscribes and email preferences, we realize some senders may have their own subscription management tools. For these senders, Marketing Campaigns supports custom unsubscribe links as well.

If you would like to use a custom URL for your unsubscribe link, from the Editor, navigate to Settings in the left-hand sidebar and select the Recipients dropdown menu. Under Unsubscribe Group, select Use Custom Link...

This will expand a new field where you can insert a URL for one of your own pages where recipients can manage their subscription preferences.

To place your Custom Unsubscribe link into your email, highlight any text within the body of your email and click the small link icon to specify a hyperlink. In the URL field that appears, enter the tag {{{unsubscribe}}}. Since you've specified your Custom Unsubscribe Link in the Settings panel, SendGrid will replace the Unsubscribe Tag with your custom URL.

You can add recipients to an unsubscribe group by uploading a CSV or adding them manually using the UI. To programmatically add recipients to an unsubscribe group, see our API documentation

To upload a CSV:

1. Find the group you want to add recipients to and click the action menu.

Expand image

2. Select Upload a CSV.
3. Drag the CSV you want to upload into the field, or click select a CSV file to upload and locate the file you want to upload from your files.
4. Click Upload CSV.

To manually add recipients to an Unsubscribe Group:

1. Find the group you want to add recipients to and click the action menu.
2. Select Manually Add.
3. Enter a recipient email address and then click Save.

From the UI, you can edit Unsubscribe Groups or download a list of recipients that have unsubscribed from your emails. For more information on managing unsubscribes, see the SendGrid Suppressions Overview

To export an Unsubscribe Group List:

1. Navigate to the Unsubscribe Group you want to export.
2. Click the action menu.
3. Select Export. Once the export is completed, a download link will be sent to the email(s) you either signed up with, or have set to receive notifications.

To edit an Unsubscribe Group:

1. Navigate to the Unsubscribe Group you want to edit.
2. Click the action menu.
3. Select Edit.

From the Edit Group page, you can change the Group Name, Group Description, and display preferences.

To delete an Unsubscribe Group:

1. Navigate to the Unsubscribe Group you want to delete.
2. Click the action menu.
3. Select Edit. The Edit Group page opens.
4. Click Delete Group.
5. Confirm that you want to delete the selected group and then click Delete.

Expand image

• Suppressions Overview
• Group Unsubscribes
• Global Unsubscribes