Suppression lists

Suppression lists specify groups of users who will never receive messages. Admins can create suppression lists with segment filters to narrow down a user group the same way you would for segmentation.

How it works

Suppression lists automatically apply to certain forms of messaging, but you can set exceptions for selected tags. If your selected exception tags are used in a campaign or Canvas, then that suppression list won’t apply to that campaign or Canvas. Messages from campaigns or Canvases with exception tags will still reach any suppression list users that are part of your target segments.

Messages not affected by suppression lists

As part of the beta, suppression lists will not apply to the following message types (in other words, suppression list users will still receive messages that belong to the following):

• Feature Flags
• Transactional use cases
• API campaigns
• API-triggered campaigns
• API-triggered Canvases
• Campaigns triggered by the Braze API (/messages and /send)

You don’t need to add an exception tag for any of these use cases, as suppression lists automatically won’t apply to them. To exclude a group of users from a message within these use cases, you need to create a target segment that excludes these users.

Channels affected by suppression lists

Suppression lists will automatically apply to all of the following channels (unless the campaign or Canvas contains an exception tag):

• SMS
• Email
• Push
• In-app messages
• Content Card
• Banner
• SMS/MMS
• Webhook
• WhatsApp
• LINE

Setting up suppression lists

Because suppression lists can significantly impact the messages you send, only admins can edit, save, active, and deactivate suppression lists (all users can view suppression lists).

1. Go to Audience > Suppression Lists.
   
   
   
   
2. Select Create Suppression List and add a name.
   
   
   
   
3. Use segment filters to identify the users in your suppression lists. You must select at least one.

4. Determine whether to have exceptions based on tag by checking the box beneath your segment name (refer to How it works for more information), then add the tags of campaigns or Canvases that users in this suppression list should still receive.
   
   In other words, if you add the exception tag “Shipping confirmation”, users in your suppression list will be excluded from all messaging except those that use the tag “Shipping confirmation”.
   
   
   
   
5. Save or activate your suppression list.
   • When you save, your suppression list will be saved but won’t be activated, which means it won’t go into effect. Your suppression list will remain inactive until you activate it, and inactive suppression lists won’t impact messaging (users won’t excluded from messages).
   • When you activate, your suppression list will be saved and immediately go into effect, which means users in your suppression list will immediately be excluded from campaigns or Canvases (except for ones containing an exception tag).

You can deactivate or archive suppression lists when you no longer need them.

• To deactivate, select an active suppression list and select Deactivate. Deactivated suppression lists can be reactivated later.
• To archive, do so from the Suppression Lists page.

Checking suppression list usage

In a campaign

Check the Suppression List section on the Target Audience page to view whether suppression lists are being applied to a campaign.

In a Canvas

Check the Suppression List section on the Target Audience page to view whether suppression lists are being applied to a Canvas. You can also view applied suppression lists in the Summary step.