---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/sendgrid/ui/sending-email/group-unsubscribes#article
headline: Group Unsubscribes
description: Allow recipients to unsubscribe from specific types of email you send, rather than everything you send, and stay out of the spam folder.
url: https://www.twilio.com/docs/sendgrid/ui/sending-email/group-unsubscribes
inLanguage: en
dateModified: 2026-07-21T11:17:13.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# Group Unsubscribes

A group unsubscribe happens when a recipient indicates that they would like to opt out from a specific type of email that you send via the [Unsubscribe Groups link](#group-unsubscribe-substitution-tag) from within your email. The list provided here can be filtered by email address or date.

## Search Group Unsubscribes by date

To filter the list by date, click the calendar icon in the top right corner and choose the unsubscribe dates you want to search between. Your recipient list refreshes, showing the recipients who unsubscribed between these dates.

## Download Group Unsubscribes as CSV

To download your Group Unsubscribe list as a CSV file:

1. Navigate to the Unsubscribe Groups page and locate the list you want to download.
2. Click the action menu next to the list.
3. Select **Export**. The file downloads in your browser right away.

## Remove recipients from the list

To remove recipients, select the checkboxes next to the recipient names, or select all using the checkbox next to the search box. A button appears at the top of the page that lets you remove the selected recipients from the list.

### Group Unsubscribe substitution tag

When you add the `<%asm_group_unsubscribe_url%>` tag to your email, Twilio SendGrid replaces that tag with the text "Unsubscribe From This List" wherever the tag appears in your email. This link lets your recipients unsubscribe from the unsubscribe group that you attached to this email.

Alternatively, use the `<%asm_group_unsubscribe_raw_url%>` tag, which Twilio SendGrid replaces with only the group unsubscribe URL without the hyperlinked text "Unsubscribe From This List".

> \[!NOTE]
>
> When using our ASM Global or Group Unsubscribe tags, you must pass an unsubscribe group in your API or X-SMTPAPI request for the unsubscribe link to populate.

## Manage Group Unsubscribes with the API

To manage your Group Unsubscribes programmatically, use the [Group Suppressions API](/docs/sendgrid/api-reference/suppressions-unsubscribe-groups/retrieve-all-suppression-groups-associated-with-the-user).

## Additional resources

* [Global Unsubscribes vs. Group Unsubscribes](/docs/sendgrid/ui/sending-email/index-suppressions/#suppressions-vs-unsubscribes)
* [Global Unsubscribes](/docs/sendgrid/ui/sending-email/global-unsubscribes/)
* [Invalid Emails](/docs/sendgrid/ui/sending-email/invalid-emails/)