Add Synonyms

Adobe Commerce only. Learn more.

Adding your own curated list of synonyms improves the ability of Live Search to respond to customer search requests and to keep them engaged.

Live Search synonyms 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 Add synonyms.

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 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 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 to indicate that the terms are interchangeable.

    Two-way synonym Two-way synonym

One-way synonym

  1. Click the One-way synonym type.

    Add one-way synonym Add one-way synonym

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

    One-way synonym example 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 One-way synonym

Step 3: Publish changes

When your synonym(s) are complete, click Publish changes.

It can take up to two hours for your updates to become available in the storefront.

Publish changes 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.