TABLE OF CONTENTS
Introduction
Navigate to: Marketing > Site Search > Synonyms
For an eCommerce solution things are constantly changing, which means the systems developed tend to grow continuously with time. For instance, if in an eCommerce store, the Administrator decides to assign a different name for a particular product (e.g. if Hoodie is a product, for instance, that is present in the store with different product descriptions like Hooded sweatshirt, Hoodie T-shirt). If a customer searches by a general description as Tulip then the same product with different attributes should be presented in such a search. Adding synonyms for the product would help make the product more searchable.
Synonyms indicate the flexibility to add more than one searchable keyword that can be associated with a single product. Based on the associated keyword when a user searches the product on the Web Store the application fetches the details and displays the same on the Product Listing Page
To manage synonyms first select a Catalog.
Add a new synonym by clicking the “Add New” button.
Specify the original keyword used in the Product name and its synonyms.
The below is an example . By default, Bi-directional is selected. This means if a customer searches with the original term OR the replaced by the term they will see the same search results. If Bi-directional is unchecked then searching with the original term will include the search results for the replaced by term but searching the replaced by term will not include the results for the original term.
Click the progress using the Save button.
Administrators can edit or delete the synonyms using the option provided under the Actions column.
Click Publish Synonyms to publish the entire list displayed.
Important - When Catalog is published, Synonyms will not be published.
Notes:
- On click of the Publish Synonyms button available in the admin application under Marketing >> Site Search >> Synonyms tab, index creation will be initiated and the synonyms configurations will be in effect on the Webstore once the index creation process gets completed. The index creation process will consider complete published data of the respective catalog for indexing not only the synonyms data.
- If the synonyms token filter update process fails in any case then the index creation process will not be initiated and the previously published synonyms will still be in effect on the Webstore.
- If administrators create the synonyms (not published yet from the synonyms screen) and try to create an index with a new name then synonyms changes may automatically start reflecting on the web store.
- After publishing, synonyms from the Synonyms screen changes will not reflect on the web store unless the index creation process gets completed.
- More than one keyword can be added to the synonym
- The ' and " are not acceptable in the Original Term and Replaced by term. If the given quotations are added then the index creation process fails.
- All fields with * are mandatory.
Combinations of Single and Multiple Synonyms
As there is a capability to add multiple keywords in the Synonym section, the following scenarios highlight the expected behavior as per the configuration done:
| Single Directional Synonyms | |||
| Original | Replaced By | Action | Expected Result |
| Tough shell Jacket | Hoodie | Search Toughshell Jacket | Tough shell Jacket |
| Search Hoodie | Hoodie | ||
| Tough shell Jacket, Heated Gloves | Hoodie | Search Toughshell Jacket | Tough shell Jacket, Hoodie |
| Search Hoodie | Hoodie | ||
| Search Heated Gloves | Heated Gloves, Hoodie | ||
| Tough shell Jacket | Hoodie, Heated Gloves | Search Toughshell Jacket | Tough shell Jacket, Hoodie, Heated Gloves |
| Search Hoodie | Hoodie | ||
| Search Heated Gloves | Heated Gloves | ||
| Tough shell Jacket, Hoodie | Heated Gloves, Hooded Sweatshirt | Search Toughshell Jacket | Tough shell Jacket, Heated Gloves, Hooded Sweatshirt |
| Search Hoodie | Hoodie, Heated Gloves, Hooded Sweatshirt | ||
| Search Heated Gloves | Hoodie | ||
| Search Hooded Sweatshirt | Hooded Sweatshirt | ||
| Bidirectional Synonyms | |||
| Original | Replaced by | Action | Expected result |
| Tough shell Jacket | Hoodie | Search Toghshell Jacket | Toghshell Jacket, Hoodie |
| Search Hoodie | Toghshell Jacket, Hoodie | ||
| Tough shell Jacket, Heated Gloves | Hoodie | Search Toughshell Jacket | Toghshell Jacket, Hoodie, Heated Gloves |
| Search Hoodie | Toghshell Jacket, Hoodie, Heated Gloves | ||
| Search Heated Gloves | Toghshell Jacket, Hoodie, Heated Gloves | ||
| Tough shell Jacket | Hoodie, Heated Gloves | Search Toughshell Jacket | Toghshell Jacket, Hoodie, Heated Gloves |
| Search Hoodie | Toghshell Jacket, Hoodie, Heated Gloves | ||
| Search Heated Gloves | Toghshell Jacket, Hoodie, Heated Gloves | ||
| Toughshell Jacket, Hoodie | Heated Gloves, Hooded Sweatshirt | Search Toughshell Jacket | Toghshell Jacket, Hoodie, Heated Gloves, Hooded Sweatshirt |
| Search Hoodie | Toghshell Jacket, Hoodie, Heated Gloves, Hooded Sweatshirt | ||
| Search Heated Gloves | Toghshell Jacket, Hoodie, Heated Gloves, Hooded Sweatshirt | ||
| Search Hooded Sweatshirt | Toghshell Jacket, Hoodie, Heated Gloves, Hooded Sweatshirt | ||