Suppressions Overview

Suppressions vs. Unsubscribes

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 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 send to a suppressed address will consume one email from your account.

Managing Unsubscribes

Managing unsubscribes is key to getting maximum email delivery. If your customers 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 two 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. If you’re using the marketing email tool, recipients can unsubscribe from specific types of emails that they’d rather not receive anymore.

If you are sending email through SendGrid 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.

Different Types of Suppressions

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.

Additional resources

See a mistake? Edit this page