Synonyms are the words with same/similar meanings. For example, gorgeous and beautiful, curtains and drapes etc. When a shopper searches for one word and you like to search for other similar words as well, you should use the Klevu’s synonym feature.
Follow the steps below for adding manual synonyms.
- For Magento and other platforms:
Login into Klevu Merchant Center (https://box.klevu.com) with the registered email id and password
Login into Shopify Admin → Apps → Klevu Search
- Choose the appropriate store from the drop down and Click on Synonyms tab
- You can add the synonyms in two ways, 1. bi-directional(<=>) and 2. uni-directional (=>)
Adding bi-directional synonyms:For example,
Search term: Sweater
Direction: <=> (bi-directional)
Synonym: sweatshirt, jumper, woolly, woolen
Here, all the words (Sweater, sweatshirt, jumper, woolly, woolen) are treated as synonyms of one other. In other words, when a shopper searches for one of these words, all the other synonyms of the same are searched as well.
Adding uni-directional synonyms:For example,
Search term: tablet
Direction: => (uni-directional)
Synonym: ipadHere, when a shopper searches for the term “tablet“, the words “ipad” too are searched. However, the vice-versa is not true.Under File Upload tab, you can upload a CSV file containing bi-directional or/and uni-directional synonyms. You can add both the type of synonyms in same CSV file.
Adding bi-directional synonyms:
In a CSV file, words that are synonyms of one other should be written on the same line with comma(,) as a separator.
For example, in CSV file you are adding the keywords as following
beautiful, gorgeous, lovely, stunningHere, all the words are treated as synonyms of one other. In other words, when a shopper searches for one of these words, all the other synonyms of the same are searched as well.
Adding uni-directional synonyms:
To define the uni-direction in CSV file, => sign is used following with comma (,) separated words that are synonyms of that search term.
For example, in CSV file you are adding the search term and synonym as following
apple=>ipod, iphone, ipad
Here, when a shopper searches for the term “apple”, the words “ipod”, “iphone” and “ipad” too are searched. However, the vice-versa is not true.
To add the Uni-directional synonyms in file, please make sure that you have added only one keyword before the sign (=>). Please see the examples below.
- apple=>iphone, ipad (Valid entry)
- apple, ipod=>iphone, ipad (Invalid entry)
Please note, it takes up to 15 minutes to reflect the synonyms in search results.
Frequently Asked Questions on Synonyms:
Is there any difference in how synonyms are treated in Magento versus how they are treated in Klevu?
Synonyms in Magento are treated differently than how they are used in Klevu. In Magento, when someone says “beautiful” is a synonym for the word “gorgeous“, it literally means, if someone types in “gorgeous“, use the term “beautiful” to search; do not use the term “gorgeous” at all. It is also important to note that synonyms in Magento only work when the entire query matches the words used for synonyms. Here, if someone says “gorgeous purse“, Magento will NOT replace the term “gorgeous” with the term “beautiful“.
Klevu, on the other hand, treats synonyms differently. If a customer types in “gorgeous“, Klevu will search for both the terms (i.e. “gorgeous” and “beautiful“). At the same time, it doesn’t have to be the exact query for the synonyms to work. In other words, if a customer searches for “gorgeous purse“, it will fire the following query
(gorgeous OR beautiful) AND purse
In case of the quick search UI, the query is directly submitted to the Klevu servers. The same is true for the landing page based on the Klevu template. In both the cases, synonyms provided in the Klevu Merchant center will be utilised to find the products.
If you are using the native layout option for the landing page, Magento will first look at the query and if there is any applicable synonym, it will replace the original query with the synonym specified in the Magento admin panel. This query is then submitted to the Klevu servers. If there are any synonyms applicable on this modified query, they will be utilised.
These synonyms, where applicable, are automatically added to the query at runtime and searched along with the original terms searched by the shoppers.
I have setup a bi-directional synonym entry. Why is it that the search results appear different when I search for them individually?
For example, you have added a synonym entry such as the following:
mummy <=> mother
and you are expecting that the results should be similar for whichever word you search for. However, the results may be different. Why?
Klevu is a search as you type solution. In other words, when you type a search term (e.g. mother), internally it searches for the term “mother” as well as any term that starts with the term “mother” (e.g. motherland, motherhood, mothers etc.). Thus the query Klevu fires internally is:
mother OR mother*
Now, when you have to add a synonym, the above query will change to the following:
mother OR mother* OR mummy
Please, note the addition of the synonym “mummy” in the query. However, we will not search for any term that starts with the word “mummy“. Simiarly, if you search for the term “mummy“, the query will be as following:
mummy OR mummy* OR mother
As you can see, it is very much likely that not only the result order but also the ranking of results be different.