The Blacklist management tool empowers you to control which search terms appear as search suggestions, related tags, or next queries in your search experience. Blackisting terms is useful for filtering out competitor brand names, irrelevant terms, or profanity that may surface due to collective shopper intent. Blacklisting a term does not prevent shoppers from searching for it. The term won’t appear as a suggestion, related tag, or next query; otherwise, results will still be shown if available in your catalog.

interact

Looking to gain a deeper understanding of blacklisted terms? See the Blacklist overview.

Getting started with the Blacklist management tool

When you access the Blacklist management tool in the Playboard, you view the list of blacklisted terms that have been created for your commerce store. The list displays all turned-on and off configurations, details on when they were last modified, and options to search and filter the list. If no blacklist configurations have been created yet, the list contains no rows.

You can create, edit, delete, or even temporarily turn a configuration off without having to delete it.

List view of the Blacklist management tool - (A) Filters and search, (B) Action tools, (C) Blacklist configuration list, (D) Row selector, (E) Page navigation options.

The blacklist configurations list (C) displays the details of the configured blacklisted terms:

• Language: the language set up for your implementation.
• Terms: the terms you want to include in the blacklist configuration.
• Updated on: the date and time when the last changes were made to the configuration.
• Status: the status of the configuration. It shows whether the blacklist configuration is on or off.

You can sort the results by Language, Updated on, or Status. Use the filters and search box (A) in the configuration list view to find the blacklist configuration you need. When using the search box, you can search for strict matching results to get results that match exactly the query you entered. You can choose to have non-strict matching results, including either the configurations whose name matches exactly or partially your query terms.

You can use the row selector (D) to select the number of configurations to be displayed in the list. If there is more than one page of blacklist configurations, you can navigate to other pages in the list using the page navigation options (E).

To add a new configuration from the list screen, select the + NEW button. To edit an existing configuration, click its row to open the edition screen. To edit or clone one configuration, or delete, turn on or off several configurations, select the checkbox next to the corresponding configurations and use the action tools (B) or the options displayed on the three-dot icon on the left.

Creating a blacklist configuration

You create a new blacklist configuration from the configuration list screen. Click the + NEW button.

Edit view of the Blacklist management tool - (A) Details, (B) Filters, and (C) Settings.

To create a new blacklist configuration, follow the steps below:

1. Switch the toggle button in the Details (A) section if you want the blacklist configuration to be on when saved.

   note

   If you turn the blacklist configuration off, you can turn it on later using the action tools in the configuration list screen.

2. Select the filters (B) to determine the scenarios where the blacklist configuration is displayed. Filters are determined by your implementation, however, Language is a mandatory filter.

3. Define in the Settings section (C) the terms you want to be blacklisted. Add the terms separated by a semicolon (;) or comma (,) and press the Enter key.

4. Click Save. If you have already turned on the configuration, it displays in the search results for the queries set in a matter of seconds.

Turning off a blacklist configuration

You can configure a blacklist configuration and turn it off temporarily, without having to delete it, so that you can reuse it on future occasions.

To turn an existing blacklist off:

1. Select the checkbox corresponding to the configuration you want to turn off in the list screen.

2. Select the Turn off option in the Actions tool menu to deactivate the selected configuration. A confirmation message appears at the bottom of the screen.

note

You can turn off an existing blacklist using the toggle button on the Edit screen. Use the pencil icon on the list screen to edit the configuration. You can directly create a turned-off configuration. See the Creating a blacklist configuration section and switch the toggle button off in the Details (A) section before saving changes.