---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/sendgrid/ui/sending-email/create-and-manage-unsubscribe-groups#article
headline: Manage recipients who unsubscribe
description: Recipients can choose to unsubscribe from your email messages. How you handle these requests factors heavily into your overall deliverability and sender reputation.
url: https://www.twilio.com/docs/sendgrid/ui/sending-email/create-and-manage-unsubscribe-groups
inLanguage: en
dateModified: 2026-10-08T19:20:27.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

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

1. Log in to the Twilio SendGrid console.
2. Go to **Marketing** > [**Unsubscribe Groups**][sgc-unsub].
3. Click **Create New Group**.
4. Add a human-readable name for this group in the **Group Name** box.
5. Add a human-readable description for this group in the **Group Description** box.
6. If you want the Unsubscribe Group displayed on the unsubscribe preferences page, select **Display this group on your unsubscribe preferences page**.
7. 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,

1. Log in to the Twilio SendGrid console.
2. Go to **Marketing** > [**Unsubscribe Groups**][sgc-unsub].
3. Click **⋮** (action menu) in the card for your desired Unsubscribe Group.
4. Click **Preview**.
5. 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][create-send] or [Automation][create-automation] series message, edit or create a message, then follow the steps

## Design editor

1. Open a design in the [Design Editor][].
2. Click the **Settings** drawer. The **Settings** panel appears.
3. From the **Build** tab, drag the **Unsubscribe** module into your message.
4. 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][create-unsub-grp].
5. When you have finished changes to your design, click **Save**.

## Code editor

1. Open a design in the [Code Editor][].
2. Click the **Settings** drawer. The **Settings** panel appears.
3. 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][create-unsub-grp].
4. Find the default unsubscribe block. All Twilio SendGrid templates include one.
   #### View the default HTML for an unsubscribe block
   ```html {title="Default HTML for an unsubscribe block"}
   <!-- !focus(12:20) -->
   <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">
     <div class="Unsubscribe--addressLine">
       <p class="Unsubscribe--senderName"
         style="font-size:12px;line-height:20px"
       >
         {{Sender_Name}}
       </p>
       <p style="font-size:12px;line-height:20px">
         <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>
       </p>
     </div>
     <p style="font-size:12px; line-height:20px;">
       <a class="Unsubscribe--unsubscribeLink" href="{{{unsubscribe}}}" target="_blank" style="font-family:sans-serif;text-decoration:none;">
         Unsubscribe
       </a>
       -
       <a href="{{{unsubscribe_preferences}}}" target="_blank" class="Unsubscribe--unsubscribePreferences" style="font-family:sans-serif;text-decoration:none;">
         Unsubscribe Preferences
       </a>
     </p>
   </div>
   ```
   * You can change the text `Unsubscribe` and `Unsubscribe Preferences` as you would any HTML link text.
5. When you have finished changes to your design, click **Save**.

## Custom unsubscribe link in Design editor

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

1. Open a design in the [Design Editor][].
2. Click the **Settings** drawer. The **Settings** panel appears.
3. From the **Unsubscribe Group** dropdown menu, choose **Use custom link...**.
4. Type your unsubscribe link into the **Custom Unsubscribe Link** box.
5. Highlight any text within the body of your email where the link goes.
6. Click the small link icon.
7. In the **URL** field that displays, enter the tag `{{{unsubscribe}}}`.
8. 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 emails

To upload a CSV of recipients:

1. Log in to the Twilio SendGrid console.
2. Go to **Marketing** > [**Unsubscribe Groups**][sgc-unsub].
3. Find the group to which you want to add recipients.
4. Click **⋮** (action menu).
5. Select **Upload a CSV**.
6. 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.
7. Click **Upload CSV**.

## Type emails by hand

To add recipients to an Unsubscribe Group:

1. Log in to the Twilio SendGrid console.
2. Go to **Marketing** > [**Unsubscribe Groups**][sgc-unsub].
3. Find the group to which you want to add recipients.
4. Click the action dropdown menu (the three vertical dots).
5. Select **Manually Add**.
6. Enter a recipient email address.
7. Click **Save**.

## Use the API

* To create an Unsubscribe Group, see [Create a suppression group][].
* To add email addresses to an Unsubscribe Group, see [Update a suppression group][].

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

1. Log in to the Twilio SendGrid console.
2. Go to **Marketing** > [**Unsubscribe Groups**][sgc-unsub].
3. Go to the Unsubscribe Group you want to export.
4. Click **⋮** (action menu).
5. Select **Export**.
6. 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:

1. Log in to the Twilio SendGrid console.
2. Go to **Marketing** > [**Unsubscribe Groups**][sgc-unsub].
3. Go to the Unsubscribe Group you want to edit.
4. Click **⋮** (action menu).
5. Select **Edit**. The **Edit Group** page displays.
6. From the **Edit Group** page, you can change the **Group Name**, **Group Description**, and display preferences.
7. Click **Save Unsubscribe Group**.

### Delete an Unsubscribe Group

To delete an Unsubscribe Group:

1. Log in to the Twilio SendGrid console.
2. Go to **Marketing** > [**Unsubscribe Groups**][sgc-unsub].
3. Go to the Unsubscribe Group you want to delete.
4. Click **⋮** (action menu).
5. Select **Edit**. The **Edit Group** page displays.
6. Click **Delete Group**. A confirmation modal displays.
7. If you want to delete the selected group, click **Delete**.

## Additional resources

* [Suppressions overview][]
* [Group unsubscribes][]
* [Global unsubscribes][]

[create-unsub-grp]: #create-an-unsubscribe-group

[create-send]: /docs/sendgrid/ui/sending-email/single-sends

[create-automation]: /docs/sendgrid/ui/sending-email/getting-started-with-automation

[sgc-unsub]: https://mc.sendgrid.com/unsubscribe-groups

[Create a suppression group]: /docs/sendgrid/api-reference/suppressions-unsubscribe-groups/create-a-new-suppression-group

[Global unsubscribes]: /docs/sendgrid/ui/sending-email/global-unsubscribes

[Group unsubscribes]: /docs/sendgrid/ui/sending-email/group-unsubscribes

[notifications]: /docs/sendgrid/ui/account-and-settings/notifications

[Suppressions overview]: /docs/sendgrid/ui/sending-email/index-suppressions#bypass-suppressions-and-unsubscribes

[Suppressions overview]: /docs/sendgrid/ui/sending-email/index-suppressions

[Update a suppression group]: /docs/sendgrid/api-reference/suppressions-unsubscribe-groups/update-a-suppression-group

[design library]: https://mc.sendgrid.com/design-library/your-designs

[code editor]: /docs/sendgrid/ui/sending-email/code-editor

[design editor]: /docs/sendgrid/ui/sending-email/design-editor