> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kibocommerce.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Synonyms

You can use the Search Synonyms module in Admin to add search synonyms for specific sites.

<CardGroup cols={2}>
  <Card title="Search Concepts" icon="book-open" href="/concept-guides/search-and-merchandizing" horizontal data-rec="concept-guide">
    Understand search configuration and merchandizing strategies
  </Card>

  <Card title="Watch: Search Synonyms" icon="circle-play" href="/video/search-synonyms" horizontal data-rec="video">
    See a step-by-step walkthrough of creating and managing search synonyms
  </Card>
</CardGroup>

Search synonyms are synonyms to user search queries that expand the search results. For example, a user may search for *boots*, but you want the search results to also include results for *shoes*, *slippers*, and *pumps*. You can use search synonyms to accomplish this.

Multi-word search terms are only expanded if they are contained within quotes in the search query. If a multi-word search term is not contained within quotes in the search query, each word in the search will be used to find synonyms. For example, if a shopper searches for "blue shoes" without quotes, both "blue" and "shoes" will be expanded to any applicable synonyms.

## Expansion Types

There are two search synonym expansion types: [One Way](#one-way) and [Two Way](#two-way).

### One Way

The One Way expansion type includes a term and a set of synonyms that replace the search results. This is a one way expansion; the search results are not expanded to the term or any other listed synonyms.

For example, you create the following One Way search synonym:

<img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/search-synonyms-one-way.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=7de5bc3995a96b622b523f1824ec6e6a" alt="Close-up of an example One Way expansion with the &#x22;blouse&#x22; term and several synonyms" width="909" height="144" data-path="img/search-synonyms-one-way.png" />

In the above example, searches for "blouse" will expand to include the results for "shirt," "top," and "T-shirt." However, if a user searches for "top," the search results will not include results for "blouse" or any of the other listed synonyms.

### Two Way

The Two Way expansion type does not include a term, but instead only contains a list of synonyms to which the search expands. This is a two way expansion; for any listed synonym, the search results are expanded to all other listed synonyms.

For example, you create the following Two Way search synonym:

<img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/search-synonyms-two-way.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=5836f8de8f47bece37e773241ef3d1d5" alt="Close-up of an example Two Way expansion with several synonyms" width="1014" height="148" data-path="img/search-synonyms-two-way.png" />

In the above example, searches will be expanded for any of the listed synonyms, such as "top," to also include the results for all other listed synonyms.

## Create Search Synonyms

To create a search synonym:

1. Go to **Main** > **Search** > **Synonyms**.
2. Click **Create New Synonym**.<img src="https://mintcdn.com/kibocommerce-59e68a4a/5Q3zAz2P5aHMz8ra/img/create-new-synonym.png?fit=max&auto=format&n=5Q3zAz2P5aHMz8ra&q=85&s=d8043b3d4c0aedf80d61915c92315de1" alt="The Synonyms page with a callout for the Create New Synonym button" width="925" height="270" data-path="img/create-new-synonym.png" />
3. In the new search synonym, complete the following:
   * (**One Way**) Select the **One Way** Expansion, specify a **Term** and a set of **Synonyms**. Press **Enter** to add each synonym to the list.\
     The term is the search query on which you want to expand. Refer to [One Way](#one-way) for more information.
   * (**Two Way**) Select the **Two Way** Expansion, leave the **Term** field blank, and only specify a set of **Synonyms**. Press **Enter** to add each synonym to the list.\
     Searches will be expanded for any listed synonym to all other listed synonyms. Refer to [Two Way](#two-way) for more information.
4. Click **Save**.\\
   <img src="https://mintcdn.com/kibocommerce-59e68a4a/H1YPkoqwgXOfZbZX/img/search-synonyms-save.png?fit=max&auto=format&n=H1YPkoqwgXOfZbZX&q=85&s=52e6fd40a4f1b03ecf20d5e4f3208bea" alt="Close-up of the Expansion table with a callout for the Save button while editing a row" width="887" height="184" data-path="img/search-synonyms-save.png" />
