An unsubscribe is the action an email recipient takes when they opt-out of an email list. Typically, this is done by clicking the unsubscribe link in the email.
A suppression is the action the sender takes by no longer sending to an email address when a recipient has opted out of an email list or when the recipient’s email server or provider has rejected emails sent to that address.
This is an important distinction, because from the point of view of your recipients, you as the SendGrid customer are the sender. We have made this distinction in order to clearly define the difference between an action a recipient takes and an action SendGrid takes on your behalf.
Each email you attempt to send to a suppressed address will consume one email from your account.
Managing unsubscribes is key to getting maximum email delivery. If your recipients have an easy way to tell you that they’d like to stop receiving your email, instead of using the spam button, it will give you valuable insights without affecting your reputation.
SendGrid has three different ways of processing unsubscribes depending on how you’re sending mail. If you use Subscription Tracking, recipients can unsubscribe from all of the emails you’re sending. As a transactional mail user, you also have the option to create unsubscribe groups for your transactional templates using Advanced Suppression Management. Alternatively, if you’re sending Marketing Campaigns, recipients can unsubscribe from specific types of emails that they’d rather not receive anymore, also known as Unsubscribe Groups.
If you are sending Transactional email through the SendGrid API or SMTP and have the Subscription Tracking setting turned on, an unsubscribe option will be added to the footer of every email that gets sent through your account. A user who clicks the unsubscribe link will be added to your global unsubscribe list and any future attempts to send email to those users will be suppressed, unless they’re removed. You can also manage this list manually, adding and removing addresses via the UI or with the use of API calls.
The Subscription Tracking setting also has a number of options for customization, such as a replacement tag that allows you to place the unsubscribe text somewhere in the body of the email, the ability to reword the unsubscribe message, and the ability to add a custom landing page.
If using Advanced Suppression Management in place of Subscription Tracking, an ASM tag must be included in the template.
SendGrid automatically suppresses emails sent to users for a variety of reasons in order to aid our customers in having the best possible reputation they can have by attempting to prevent unwanted mail.
Blocks - The recipient's email server rejects the message for a reason related to the message, not the recipient address. This may be due to your Sending IP, or the message content. Since these are message-specific issues, future messages to these addresses are not suppressed.
Bounces - The recipient’s email server rejects the message, or sends the message back to SendGrid, due to an issue with the recipient address.
Invalid Emails - The recipient address does not exist at the mail server you sent to.
Spam Reports - The recipient marks your email as spam.
Global Unsubscribes - When a user unsubscribes from everything you might email them.
Group Unsubscribes - When a user unsubscribes from a specific group of your emails.
Bypass filters allow you to disregard unsubscribe groups and suppressions to ensure that an email is delivered to all recipients, whether or not they are on a suppression or unsubscribe list. It is important to respect unsubscribes, and these filters should be used only when it is absolutely necessary to deliver a message to recipients who have unsubscribed from your emails. For example, you may use these filters to deliver messages that you are legally required to send to all recipients or important security messages like a password reset.
Both the X-SMTPAPI header and the v3 Mail Send API accept the
bypass_list_management filter. By setting the
bypass_list_management filter to
true, your message will bypass all unsubscribes and suppressions in all lists.
The v3 Mail Send API provides three filters in addition to
bypass_list_management. These additional filters allow you to bypass a single list. You can also pass multiple bypass filters to the v3 Mail Send API to target a combination of lists; however, the
bypass_list_management filter cannot be combined with any other bypass lists. When using the
bypass_list_management filter, you are disregarding all lists, and any more granular bypass settings will be ignored.
Each filter should be sent via the
mail_settings field as an object with a single boolean field called
"enable". When a filter is set to
true, Twilio SendGrid will disregard or bypass the unsubscribe or suppression status of the addresses in the list, delivering the message to the recipients. See the v3 Mail Send API reference for examples.
Bypass spam management
true, your message will bypass the spam report list. The bounce and global unsubscribe lists will be checked and respected.
Bypass bounce management
true, your message will bypass the bounce list. The spam report and global unsubscribe lists will be checked and respected.
Bypass unsubscribe management
true, your message will bypass the global unsubscribe list. The spam report and bounce lists will be checked and respected. Note that this bypass filter is applied to global unsubscribes only; group unsubscribes will be checked and respected.
Let us know how we’re doing! Please rate this page:
Please note, we cannot resolve account and login issues reported on GitHub. Contact support for account assistance.
Thanks for helping us improve our docs!