Manage recipients who unsubscribe

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.

Create an Unsubscribe Group

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

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 displayed on the unsubscribe preferences page, select Display this group on your unsubscribe preferences page.
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 Single Send or Automation series message, edit or create a message, then follow the steps

Design editorCode editorCustom unsubscribe link in Design editor

Open a design in the Design Editor.
Click the Settings drawer. The Settings panel appears.
From the Build tab, drag the Unsubscribe module into your message.
From the Unsubscribe Group dropdown menu, choose an existing Unsubscribe Group, Create Unsubscribe Group, or Use Global Unsubscribe.
- If you choose Create Unsubscribe Group, the Create an Unsubscribe Group modal displays.
  1. Click Create an Unsubscribe Group.
  2. Follow the same steps from the Create an Unsubscribe Group section.
When you have finished changes to your design, click Save.

Open a design in the Code Editor.
Click the Settings drawer. The Settings panel appears.
From the Unsubscribe Group dropdown menu, choose an existing Unsubscribe Group, Create Unsubscribe Group, or Use Global Unsubscribe.
- If you choose Create Unsubscribe Group, the Create an Unsubscribe Group modal displays.
  1. Click Create an Unsubscribe Group.
  2. Follow the same steps from the Create an Unsubscribe Group section.
Find the default unsubscribe block. All Twilio SendGrid templates include one.
View the default HTML for an unsubscribe block
Default HTML for an unsubscribe block
1
<div data-role="module-unsubscribe" class="module" role="module" data-type="unsubscribe" style="color:#444444; font-size:12px; line-height:20px; padding:16px 16px 16px 16px; text-align:Center;" data-muid="4e838cf3-9892-4a6d-94d6-170e474d21e5">
2
<div class="Unsubscribe--addressLine">
3
<p class="Unsubscribe--senderName"
4
style="font-size:12px;line-height:20px"
5
>
6
{{Sender_Name}}
7
</p>
8
<p style="font-size:12px;line-height:20px">
9
<span class="Unsubscribe--senderAddress">{{Sender_Address}}</span>, <span class="Unsubscribe--senderCity">{{Sender_City}}</span>, <span class="Unsubscribe--senderState">{{Sender_State}}</span> <span class="Unsubscribe--senderZip">{{Sender_Zip}}</span>
10
</p>
11
</div>
12
<p style="font-size:12px; line-height:20px;">
13
<a class="Unsubscribe--unsubscribeLink" href="{{{unsubscribe}}}" target="_blank" style="font-family:sans-serif;text-decoration:none;">
14
Unsubscribe
15
</a>
16
-
17
<a href="{{{unsubscribe_preferences}}}" target="_blank" class="Unsubscribe--unsubscribePreferences" style="font-family:sans-serif;text-decoration:none;">
18
Unsubscribe Preferences
19
</a>
20
</p>
21
</div>
- You can change the text Unsubscribe and Unsubscribe Preferences as you would any HTML link text.
When you have finished changes to your design, click Save.

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

Open a design in the Design Editor.
Click the Settings drawer. The Settings panel appears.
From the Unsubscribe Group dropdown menu, choose Use custom link....
Type your unsubscribe link into the Custom Unsubscribe Link box.
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}}}.
When you have finished changes to your design, click Save.

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 of recipients:

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.