Thanks to the Synonyms functionality, you can set the same search results for different search queries.


ON THIS PAGE


What is a synonym?

A synonym is a word or phrase that means exactly or nearly the same as another word or phrase in the same language.


How to use synonyms?

Similar words or phrases

Your customers may use different words to describe products in your store. Often, these words are not included in the title or description of the product they are looking for, which leads to disappointing search results.

For example, declare a synonym for the word "pants" to be "trousers". When the word "trousers" is searched in the storefront, the search results will be the same as if the word "pants" was searched. In both cases, the results for "pants" will be shown. 

This will work differently in reverse: if you set "pants" to be a synonym for "trousers", then both searches will return the result for "trousers".


Plurals

You can also use synonyms to refer the plural form of a noun to its singular form in the product name and vice versa. For example, when your customers search for "chocolates", Milka chocolate will be shown in the search results. If you don't use synonyms, nothing will be found.


Managing synonyms

Adding synonyms

  1. Go to the Smart Search & Filter control panel > Synonyms section.
  2. Click the + button on the top right.
  3. Enter the synonyms separated by commas in the left column. These are the words or phrases that your customers are looking for, in other words, search queries. 
  4. Enter the search term in the right column. It's the word or phrase that will be found. 
    Note
To avoid any issues with the Synonyms feature, we highly recommend that you create synonym combinations avoiding the repeating of the words in the left and right columns. So that all the words that are synonyms and search terms were unique.
  5. Save the changes.
  6. Click the Force re-indexation button in the Dashboard section to start the indexation.

That's all. After the indexation is complete, you can go to the storefront and test how the synonyms work.


Editing synonyms

  1. Go to the Smart Search & Filter control panel > Synonyms section.
  2. Click the Edit synonyms button at the top.
  3. Edit the items.
  4. Save the changes.
  5. Click the Force re-indexation button in the Dashboard section to start the indexation.


Deleting synonyms

  1. Go to the Smart Search & Filter control panel > Synonyms section.
  2. Select the synonyms you want to delete on the Delete column.
  3. Click the Delete selected (...) button.
  4. Confirm deleting.
  5. Click the Force re-indexation button in the Dashboard section to start the indexation.


Exporting synonyms

To export synonyms, follow these steps:

  1. Go to the Smart Search & Filter control panel > Synonyms section > Export/Import tab > Export part.
  2. Click the Download as CSV button.
  3. Choose the directory to save the exported file.

That's all. The CSV file is exported.


Importing synonyms

To import synonyms, follow these steps:

Important
The file must contain the header fields: Synonyms, Search term.
The CSV file size is limited by the server settings. At the moment the maximum file size is 2 MB.
  1. Go to the Smart Search & Filter control panel > Synonyms section > Export/Import tab > Import part.
  2. Select the CSV Delimiter that is used in the imported CSV file.
  3. Click the Choose file button and choose the file for importing.
  4. Click the Import button. You can see the imported values in the General tab.
  5. Click the Force re-indexation button in the Dashboard section to start the indexation.

That's all. After the indexation is complete, you can go to the storefront and test how the synonyms work.