Rate this page:

Global Unsubscribes

Global unsubscribes happen when a recipient indicates that they would like to opt out from any email that you send by clicking on the Unsubscribe From All Emails link within your emails. The list provided here can be filtered by email address or date.

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

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.

Download Global Unsubscribes as CSV

To download your Global Unsubscribe list as a CSV:

  1. Navigate to the Global Unsubscribes page.
  2. Click the action menu at the top of the page.
  3. Select Download as CSV. The file will download in your browser right away.

Global Unsubscribe Substitution Tag

When you add the <%asm_global_unsubscribe_url%> tag to your email, we will replace that tag with the text "Unsubscribe From All Emails", wherever the tag is found in your email. This will allow your recipient to be globally unsubscribed from all of your emails.

Alternatively, you can use the <%asm_global_unsubscribe_raw_url%> tag, which will be replaced with only the global unsubscribe URL without the hyperlinked text "Unsubscribe From All Emails".

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