Synonyms

If you have a situation where you want a search term to expand to cover additional possible searches, you can create synonyms.

Note:

Synonyms are automatically stemmed using a minimal English algorithm. There is no need to create singular and plural versions of synonyms. For example, a synonym that expands iPad to tablet will also expand iPads to tablet.

One-way Synonyms

You would use these to expand a search:

For example: Search for computers will expand to also search for laptops. But not the other way - which will prevent results for computers surfacing when a user searches for laptops.

Two-way Synonyms

In this query rewrite, a search for “boots” would get expanded to “shoes” and vice versa.

Multiple Values

You can enter multiple values into the expansion of a 1-way synonym, or into the 2-way synonym. Multiple synonyms can be entered using the following formatting.

Values are separated by commas
```
 aaa, bbb, ccc
```
Any value that includes double-quotes or commas must be enclosed in double-quotes
```
 aaa, "1,000", ccc
```
If double-quotes are used to enclose a value, then a double-quote appearing inside a value must be escaped by preceding it with another double-quote
```
 aaa,bbb,"world's ""best"" product","""products"""
```
would be the format for the values: aaa, bbb, world's "best" product, and "products"

Warning:

Overuse of synonyms will slow down your search. There is a limit of a 100 synonyms per entry. This limit includes the triggering terms for a 1-way synonym. When you add more than 4 two-way synonyms, you will incur slower queries. Each additional synonym slows down your performance. The correct way to address underlying data gaps is to tag your products at record level, as this will leverage the search engine’s performance capabilities via indexing.