Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

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 from within your email. The list provided here can be filtered by email address or date.


Search Group Unsubscribes by date

search-group-unsubscribes-by-date page anchor

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

download-group-unsubscribes-as-csv page anchor

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

remove-recipients-from-the-list page anchor

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

group-unsubscribe-substitution-tag page anchor

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

(information)

Info

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

manage-group-unsubscribes-with-the-api page anchor

To manage your Group Unsubscribes programmatically, use the Group Suppressions API.