Suppression lists

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

Why use suppression lists?

Suppression lists are dynamic and 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 emails
• API campaigns

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 are dynamic and 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

By default, suppression lists will apply to any API-triggered campaigns and API-triggered Canvases. You can change this by checking Do not apply this suppression list to all API-triggered campaigns and API-triggered Canvases in the Exception Settings section.

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.

Suppression list usage

To check if your suppression list prevented a user from receiving a message, use User Lookup in the Target Audience step within your campaign or Canvas. Here, you’ll be able to see which suppression list they’re part of.

While creating a campaign or Canvas, use User Lookup within the Target Audience step to search for a user, and if they aren’t in the target audience, you can see the suppression list they’re part of.

• campaign
• canvas