Manage recipients who unsubscribe

To manage voluntary opt-out actions from recipients, use Unsubscribe Groups.

Create an Unsubscribe Group

To comply with anti-spam laws, protect your sender reputation, and respect your recipients' preferences, add unsubscribe groups to your email messages. To create an unsubscribe group, follow these steps:

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.

Throughout this procedure, your Unsubscribe and Unsubscribe Preference pages in the Preview window updates as you make the changes.

View Unsubscribe pages

To view the Unsubscribe and Unsubscribe Preferences pages linked to your Unsubscribe Group,

Log in to the Twilio SendGrid console.
Go to Marketing > Unsubscribe Groups.
Click ⋮ (action menu) in the card for your desired Unsubscribe Group.
Click Preview.
To view the Unsubscribe Preferences page, click Unsubscribe Preferences.

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:

Log in to the Twilio SendGrid console.
Go to Marketing > Unsubscribe Groups.
Find the group to which you want to add recipients.
Click ⋮ (action menu).
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.
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:

Log in to the Twilio SendGrid console.
Go to Marketing > Unsubscribe Groups.
Go to the Unsubscribe Group you want to export.
Click ⋮ (action menu).
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:

Log in to the Twilio SendGrid console.
Go to Marketing > Unsubscribe Groups.
Go to the Unsubscribe Group you want to edit.
Click ⋮ (action menu).
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:

Log in to the Twilio SendGrid console.
Go to Marketing > Unsubscribe Groups.
Go to the Unsubscribe Group you want to delete.
Click ⋮ (action menu).
Select Edit. The Edit Group page displays.
Click Delete Group. A confirmation modal displays.
If you want to delete the selected group, click Delete.