Rate this page:

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.

Searching Group Unsubscribes by Date

In the top right corner, you will see a calendar icon. Click this and choose the unsubscribe dates you would like to search between. Your recipient list will refresh, showing the recipients who unsubscribed between these dates.

Download Group Unsubscribes as CSV

To download your Group Unsubscribe list as a CSV:

  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 will download in your browser right away.

Removing Recipients From The List

When you select the checkboxes next to the recipient names or select all, using the checkbox next to the search box, you will see a new button at the top of the page. From this list, you can choose to remove the selected recipients from the list.

Group Unsubscribe Substitution Tag

When you add the <%asm_group_unsubscribe_url%> tag to your email, we will replace that tag with the text "Unsubscribe From This List", wherever the tag is found in your email. This link will allow your recipients to unsubscribe from the unsubscribe group that you attached to this email.

Alternatively, you can use the <%asm_group_unsubscribe_raw_url%> tag which will be replaced with only the group unsubscribe URL without the hyperlinked text "Unsubscribe From This List".

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.

Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the SendGrid tag on Stack Overflow.


        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

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

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more