Create and Manage SendGrid Unsubscribe Groups

IMPORTANT NOTE: These action items are done in the SendGrid interface. Use the credentials used to activate the integration to access SendGrid at app.sendgrid.com

Adding Unsubscribe Groups to your emails makes it easy to honor your recipients' email preferences and protect your sender's reputation by complying with anti-spam legislation.

Create an Unsubscribe Group

To create an Unsubscribe Group:

1. Select Marketing and then click Unsubscribe Groups.
2. Click Create New Group.
3. Add Group Name and Group Description.
   IMPORTANT NOTE: Make sure your Group Names and Group Descriptions are customer-friendly. This is what your recipients will see.
4. Select the checkbox if you want the Unsubscribe Group to display on the unsubscribe preferences page.
5. Click Save Unsubscribe Group.

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

Adding an Unsubscribe Group to your Email

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, 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:

TextText
<a href="{{{unsubscribe}}}">Click here to unsubscribe.</a>
<span aria-hidden="true" class="line-numbers-rows" style="margin: 0px; padding: 0px; box-sizing: border-box; position: absolute; pointer-events: none; top: 0px; font-size: 14.4px; left: -3.8em; width: 3em; letter-spacing: -1px; border-right: 1px solid rgb(153, 153, 153); user-select: none;"><span style="margin: 0px; padding: 0px; box-sizing: border-box; display: block; counter-increment: linenumber 1;"></span></span>

Using a Custom Unsubscribe Link

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

If you want 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 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.

Add recipients to an Unsubscribe Group.

You can add recipients to an unsubscribe group by uploading a CSV or adding them manually using the UI.

Upload a CSV

1. Find the group to which you want to add recipients and click the action menu.
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.

Manually Add recipients to an Unsubscribe Group

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

Managing Unsubscribe Groups

From the UI, you can edit Unsubscribe Groups or download a list of recipients unsubscribed from your emails.

Exporting an Unsubscribe Group List

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.

Editing an Unsubscribe Group

To edit an Unsubscribe Group:

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

You can change the Group Name, Group Description, and display preferences from the Edit Group page.

Deleting an Unsubscribe Group

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, then click Delete.