Managing Synonyms in CloudSearch
page last edited on 16 April 2018
Synonyms is another feature available to users on paid accounts. It can be used to fine-tune your customers’ search experience by specifying queries that should be treated equally. For example if you want the search queries “TV”, “Television”, “TV set” and “Television set” to all be equivalent and produce the same search results, just place these queries in a single synonym group. While the most common use for this feature is lexical synonyms such as “sneakers” and “sport shoes”, more advanced and creative scenarios are indeed possible and can be beneficial for the overall site search performance. For example, one can use synonyms to redirect queries returning few or no results at all to some good results. (Tip: Use the Statistics feature to discover such queries.) In that sense synonyms can be thought of as a more generalized form of the Promotions feature. Another context where synonyms can be useful for enhancing site search is multilingual product (or brand) names. Queries with localized brand names can be induced to return correct results simply by putting the “correct” and “incorrect” queries in a single synonym group. Also, synonyms can be used to fix incorrect but nevertheless common misspellings of product titles, brands or other names in complicated situations where automatic spelling corrections are unable to help.
Synonyms can be added and managed via the Synonyms tab in the Catalog -> CloudSearch & CloudFilters section of the Admin area.
To add a synonym group:
Click Add synonyms:
A popup titled Add synonyms will appear.
In the popup, click inside the input field and specify up to five search queries that you want to be treated as synonymous (You must enter at least two words or phrases.) To enter multiple search queries, separate the individual queries with commas (,) or press ENTER after each query as you type.
Click Add synonyms.
The synonym group will be created.
Now if you try searching with these queries in the store front end, the search results will be the same for all the queries from the group.
If necessary you can add synonyms to an existing group:
Or you can remove specific synonyms from a group:
You can also remove the group itself:
The addon supports the import and export of synonyms. You can find the links for access to the respective sections at the top of the Synonyms section:
Import and export are carried out in the CSV format.
To add your existing synonyms to CloudSearch via import:
Create a .csv file and add your list of synonyms to it. In the file, each group of synonyms must be placed on a separate line. A comma must be used as a delimiter between the individual synonyms.
Go to the import section using the link at the top of the section Synonyms:
Specify the file that needs to be imported.
Use the setting Delete all existing synonyms before importing to specify whether CloudSearch should remove from the system any existing synonyms, or simply add the new synonyms to the existing ones.
Click Upload file.
After the file upload has completed, the synonyms from the file will be added to the system, and you will be able to find them in the section Synonyms.
To export synonyms previously added to CloudSearch to a .csv file, use the link Export.
Help make this document better
This guide, as well as the rest of our docs, are open-source and available on GitHub.