Create and Manage Unsubscribe Groups

This tutorial describes the Marketing Campaigns experience. If you're using legacy Marketing Campaigns, your workflow and screens might differ. To learn more about the Marketing Campaigns experience, see Twilio SendGrid Pricing.

Adding unsubscribe groups to your emails helps you comply with anti-spam laws, protect your sender reputation, and respect your recipients' preferences.

Create an unsubscribe group

To create an unsubscribe group

Log in to the Twilio SendGrid console.
Go to Marketing > Unsubscribe Groups.
Click Create New Group.
Add a human-readable name for this group in the Group Name box.
Add a human-readable description for this group in the Group Description box.
If you want the unsubscribe group to display on the unsubscribe preferences page, select the checkbox.
Click Save unsubscribe group.

(information)

Info

To view the unsubscribe preferences page, select the action menu next to an unsubscribe group and then click Preview. Toggle to the Unsubscribe Preferences tab to view all of the options listed.

Add an unsubscribe group to your email

To add an unsubscribe group to your email campaign:

Design editorCode editorCustom unsubscribe link in Design editor

Go to Settings.
Select your preferred unsubscribe group fromthe Recipients dropdown menu.
From the Build tab, drag the Unsubscribe module to insert Sender Information and a link to the {{{unsubscribe}}} tag.
To set the hyperlink for the {{{unsubscribe}}} tag, enter the text you want to link.
Highlight the text then select the link icon from the top toolbar.
In the URL box, type {{{unsubscribe}}}.
Click Save.

Go to Settings.
Click Recipients.
Enter the following code styling to the HTML window where you want your unsubscribe content placed:
<a href="{{{unsubscribe}}}">Click here to unsubscribe.</a>

For senders with their own subscription management tools, Marketing Campaigns supports custom unsubscribe links.

Go to Settings.
From the Recipients dropdown menu under Unsubscribe Group, select Use Custom Link.... A URL box displays.
This expands a field where you can insert a URL for one of your own pages where recipients can manage their subscription preferences.
Highlight any text within the body of your email where the link goes.
Click the small link icon.
In the URL field that displays, enter the tag {{{unsubscribe}}}.

Twilio SendGrid replace the Unsubscribe Tag with your custom URL.

Add recipients to an unsubscribe group

To add recipients to an unsubscribe group, choose from three options: upload a CSV of email addresses, type each email address in the console, or use the API.

Upload CSV of emailsType emails by handUse the API

To upload a CSV:

Find the group you want to add recipients to
Click the action dropdown menu (the three vertical dots).
Select Upload a CSV.
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.
Click Upload CSV.

Manage your unsubscribe groups

From the console, you can edit unsubscribe groups or download a list of recipients that have unsubscribed from your emails. To learn more about managing unsubscribed emails, see the Suppressions Overview.

Export an unsubscribe group list

To export an unsubscribe group list:

Go to the unsubscribe group you want to export.
Click the action dropdown menu (the three vertical dots).
Select Export.
Once the export completes, Twilio SendGrid sends you a download link to the email address you used to register or set to receive notifications.

Edit an unsubscribe group

To edit an unsubscribe group:

Go to the unsubscribe group you want to edit.
Click the action dropdown menu (the three vertical dots).
Select Edit. The Edit Group page displays.
From the Edit Group page, you can change the Group Name, Group Description, and display preferences.
Click Save unsubscribe group.

Delete an unsubscribe group

To delete an unsubscribe group:

Go to the unsubscribe group you want to delete.
Click the action dropdown menu (the three vertical dots).
Select Edit. The Edit Group page displays.
Click Delete Group. A confirmation modal displays.
If you want to delete the selected group, click Delete.