Create and Manage Unsubscribe Groups

This page is describing the functionality of the new Marketing Campaigns experience. If you're using legacy Marketing Campaigns, your workflow and screens may be a little different. For more information on the new Marketing Campaigns experience click here.

Adding Unsubscribe Groups to your emails makes it easy to honor your recipients' email preferences and protect your sender 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 a Group Name and Group Description.

Make sure your Group Names and Group Descriptions are customer-friendly. This is what your recipients will see.

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

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.

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 {{{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>

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 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.

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. 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.

Unsubscribe action menu

  1. Select Upload a CSV.
  2. 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.
  3. 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.

Managing Unsubscribe Groups

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

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.

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

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

Unsubscribe delete menu

Additional Resources

Rate this page:

Need some help?

We all do sometimes. Get help now from the Twilio SendGrid Support Team.

Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!

thanks-feedback-gif