Suppression lists

Suppression lists are part of the Audiences section in the Data navigation menu. Any existing suppression lists will be displayed on the page by default.

Data can be added to a list either manually, which is useful for servicing a request to restrict processing, on a record-by-record basis, by uploading a CSV formatted file or using the API Suppression import method. An entire list can also be downloaded for use within another platform, for example, a CRM system.

👍

Number of suppression lists

Whenever sending a campaign, the system checks against the subscription status for that channel and also against suppression lists. Users in the suppression lists aren't targeted and won't be included on the recipient count.

For this reason, it's recommended to minimise the number of suppression lists as each one needs to be checked when calculating the recipient for every campaign sent.

Create a suppression list

To create a new suppression list, navigate to Data > Audiences and select the Suppression Lists tab.

Click Create Suppression List, enter a name for your list and select a user identifier from the Identifier drop list.

Add data to a suppression list

Navigate to Data > Audiences and select the Suppression Lists tab.

Manually

Click the name of the suppression list required. All existing list records will be displayed in paged format.

Click Add Item, enter the user record identifier configured for this list, for example the user email address and click the save icon.

CSV import

Click the name of the suppression list required. All existing list records will be displayed in paged format.

Click Import from CSV, browse your local computer for the correct file and click Open.

👍

CSV format to import to a suppression list

As the record identifier has been selected when creating the suppression list, your CSV file does not need a column header, and the file should have only one column containing just the values that match the identifier type selected.

The CSV file import starts immediately, with the import task information displayed on the page. You can continue with other tasks as the import may take some time depending on the number of records included. To review the import progress at any time, navigate to Data > Task History.

Via API

The suppression list import method allows adding or removing recipients from a suppression list in bulk. Review our API reference for more details.

Remove records from a suppression list

Manually

It is possible to remove individual records from the UI.

To do so, navigate to Data > Audiences and select the Suppression Lists tab.

Select the list that includes the data record for removal.

Enter the record identifier into the search field, the corresponding record is displayed.

Click the options menu and then click Delete.

Via API

Use the suppression list import method to remove recipients in bulk. Include the parameter mode to specify that you want to delete records. Review our API reference for more details.

Export data from a suppression list

Navigate to Data > Audiences and select the Suppression Lists tab.

Click Export to CSV.

The export starts immediately. Once complete, the export file name is displayed on the Task Details page. Click the filename to download. You can continue with other tasks as the export may take some time depending on the number of records included. To review the export progress at any time, navigate to Data > Task History.

Delete a suppression list

It is possible to delete a suppression list from the platform. To do so Navigate to Data > Audiences and select the Suppression Lists tab. Click on the options menu and click on Delete.

📘

It is only possible to delete lists that are empty, so you will need to remove all the recipients before being able to delete a suppression list.