Add Synonyms

Increase customer engagement by adding your own curated list of Live Search synonyms. Live Search can manage up to 200 synonyms per Data Space ID.

Live Search synonyms

Step 1: Add a synonym

  1. In the Admin, go to Marketing > SEO & Search > Live Search.
  2. For multiple stores, set Scope to the store view where the synonym settings apply.
  3. Click the Synonyms tab.
  4. Click the Add synonyms button.

Step 2: Define the synonym by type

Follow the instructions for the type of synonym that you want to create.

Two-way synonym

  1. Accept the default Two-way option.

    Add two-way synonym

  2. Enter the Keyword term or phrase to be matched.

  3. Enter the Expansion term(s) that you want to add as synonyms for the keyword. Separate multiple terms with a comma.
    In this example, the keyword to match is “pants” and the set of expansion terms are “long pants, trousers, slacks”.

    Two-way synonym example

  4. When complete, click Save.
    The set of synonyms appears in the list with a two-way arrow between each term that means the terms are interchangeable.

    Two-way synonym

One-way synonym

  1. Click the One-way synonym type.

    Add one-way synonym

  2. Enter the Keyword and Expansion term(s). Separate multiple terms with a comma.

    One-way synonym example

    In this example, the keyword is “pants” and the one-way expansion terms “capris, calf-length pants, peddle-pushers” are each a subset of “pants”, but with a specific meaning.

  3. When complete, click Save.
    The set of synonyms appears in the list with a one-way arrow pointing from the expansion terms to the keyword to indicate the terms are subsets of the keyword. A plus sign separates each expansion term.

    One-way synonym

Step 3: Publish changes

  1. When your synonym(s) are complete, click Publish changes.
  2. Wait for up to two hours for your updates to become available in the storefront.

Publish changes

Field Descriptions

Field Description
Type Determines if the synonyms have the same meaning as the keyword, or are a subset of the keyword. Options:
Two-way (default) - Terms that have the same meaning as the keyword and return the same search results
One-way - Terms that are a subset of the keyword. One-way synonyms return a more narrow list of specific products.
Keyword A word that is commonly associated with a selection of products in your catalog.
Expansion Additional terms that have the same or similar meaning as the keyword.

On this page