Dynamic Synonym Suggestions
On this page
Synonyms are words that share a similar meaning. Adding synonyms to your search helps your users find relevant results even if they use different words to express the same concept. For example, by adding a synonym for trousers and pants, a search for either term returns identical results.
This feature isn’t available on every plan. Refer to your pricing plan to see if it’s included.
Get started
To activate Dynamic Synonym Suggestions for one of your indices:
- Go to the Algolia dashboard and select your Algolia application.
- On the left sidebar, select Search.
-
Select your Algolia index:
- Open the AI Synonyms page and select Activate for this index.
Send a user token with your searches
To find suggestions, Algolia determines how often users rewrite a search term. To make that more accurate, send user tokens with your search requests. For more information, see Distinguish users for analytics.
Review synonyms
The Suggested Synonyms tab shows new suggestions. To show all suggestions, turn off the Show only new synonyms option.
As you examine a suggested synonym, you’ll see metrics to help you select the better option: the original term or the suggestion. These metrics include:
- Conversion rate (CVR)
- Click-through rate (CTR)
- Result count
- Confidence score
If you’re sending click and conversion events, you can compare click-through and conversion rates for both alternatives.
What the confidence score means
Each suggestion includes a confidence score between 0 and 100. It helps you find the synonym suggestions with the highest probability of improving your search results. Two machine learning models determine the score:
- A semantic similarity model which measures how closely related the terms are.
- A confidence scoring model that converts this semantic similarity into a probability that the suggested synonym will enhance search relevance.
For example:
- A score of 90 means there’s a 90% chance the suggested synonym will improve your search results.
- A score of 10 means it’s unlikely to help.
Accept or decline suggestions
To accept a suggestion, click Add to configuration (✓
).
If you don’t want to add this suggestion to all replicas of this index, turn off the Forward to replicas option at the top.
You can edit accepted suggestions in the Accepted suggestions tab.
To decline a suggestion, click Decline this suggestion (x
).
You can edit and accept declined suggestions in the Declined suggestions tab.
After accepting a suggestion, only edit it in the dashboard, not with the API.
Change synonym types
By default, the AI suggests adding regular two-way synonyms.
To change to another synonym type,
hover over the suggestion and click the Edit button.
Then, click Select Type (⇔
) and select a synonym type.
Edit suggestions
To edit a suggestion, hover over it and click the Edit button. Then, you can edit both synonyms or add more.
Alternative suggestions
Sometimes, there are several suggestions for the same search query. To see the alternative suggestions, click More suggestions.
How Dynamic Synonym Suggestions work
Dynamic Synonym Suggestions provides a list of synonyms that may improve your search experience by considering how users rewrite their queries and the historical performance of different searches.
User query rewrites
Algolia analyzes user sessions to detect when people change their search query. If a user searches for a word and then changes the query to use a different word, that implies a potential synonym.
To qualify as a synonym suggestion:
- Users must search for one word and then change the query to another word (within about a minute).
- The two words must seldom appear together in the same query, suggesting they’re potential synonyms rather than companions. For example, since “sneakers” and “trainers” are often synonyms, they’re unlikely to appear in the same query. However, “sneakers” and “laces” may frequently co-occur and, hence, are companions.
For each index, the evaluation considers analytics data from the last 30 days.
For multi-word terms, Algolia examines the frequency of these terms across different search queries to confirm they’re potential synonyms and not part of a set phrase.
Rewrite count
Each synonym suggestion includes a rewrite count, which reflects how often users switched from one word to another during the preceding week. The more frequent this behavior is among your users, the higher the count.
Search performance analysis
Algolia uses your analytics data to see how well each search term performs. It only considers terms that users have typed into the search box.
Low-performing terms are terms that lead to low engagement (few clicks, low conversions) or poor result quality (few or zero results).
For each of these low-performing terms, Algolia suggests synonyms that are linguistically similar and likely to improve search outcomes. For example, if users frequently search for “denim trousers” but that term leads to few clicks, “jeans” might be a synonym suggestion.