Guides / Algolia AI

Dynamic Synonym Suggestions

Synonyms are a powerful tool when you want to tweak the relevance of your search. They tell our engine to treat different words as equal so that it’s easier for your users to find what they’re looking for. For example, if your records contain the keyword “pants”, but your users search for “trousers”, adding the synonym trousers ⇔ pants ensures that your users find relevant search results.

However, identifying the synonyms you should add can involve many manual steps. You have to check the queries that return no (or almost no) results, find the closest synonym that would match the records you expect, and then create these synonyms.

Our Dynamic Synonym Suggestions feature automates this process for you. Using AI, we identify queries that your users often change and propose synonyms for them. For example, if our AI detects that many users search for “trousers” and then change their query to “pants”, it can suggest the synonym trousers ⇔ pants. All you have to do is accept or decline the suggested synonym. You can also tweak the suggestion before accepting it, if you think there’s a better alternative.

This feature is currently in open beta and is available to Standard and Premium plans. After the beta, only Premium plans can access this feature.

Getting started

To get started with Dynamic Synonym Suggestions, navigate to the AI Synonyms page in the sidebar of the dashboard. From here, you can review, modify, accept, and decline the synonyms that our AI suggests.

Reviewing synonyms

Ready-for-review synonym suggestions appear in the Suggested Synonyms tab. Initially, you may not find any suggestions there: your application needs a certain amount of search traffic for our AI to generate synonyms reliably. Depending on your usage, it may take some time to reach this threshold. We’ll show you a warning on the dashboard if you don’t have enough traffic to generate synonym suggestions.

By default, we only show the newest synonym suggestions. You can review older suggestions by turning off the Show only new synonyms toggle at the top of suggestions list.

Each suggestion has an explanation that provides context on why our AI suggests it. For example, if our algorithm proposes a synonym for trousers ⇔ pants, it tells you that users often rewrite the query “blue trousers” as “blue pants”.

While our AI can suggest synonyms based on your users’ searches, it doesn’t determine the best type of synonym. It’s up to you to decide which type works best for the suggested synonym. By default, we propose a two-way synonym. You can change this to a one-way synonym or alternative correction using the dropdown between the two terms of the synonym.

Changing the type of the suggested synonym

Tweaking synonyms

You can also change suggested synonyms. For example, if our AI finds that users rewrite the query “card holder” to “card wallet”, a suggested synonym could be holder ⇔ wallet. If you enable this suggestion as is, if your users search for “holder”, they would also find wallets. This might not be the desired outcome. To see alternative suggestions for this synonym, you can click on More options at the right of the suggestion. This reveals a dropdown with other suggestions for this synonym, such as card holder ⇔ card wallet.

A list with other suggestions for this synonym

Accepting or rejecting synonyms

When you’re happy with the suggested synonym, you can easily accept the synonym by pressing the button with the checkmark (). If you want to reject the synonym, click the button with the cross (x).

If your index has replicas and you don’t want to forward accepted synonyms to these replicas, turn off the Forward to replicas setting at the top of the AI Optimization page.

Once you accept a synonym, you should only change it from the dashboard. Changing these synonyms with an API client can lead to data inconsistencies, and should be avoided at all times.

You can view all the synonyms you’ve accepted in the past in the Accepted Synonyms tab. All your rejected synonyms show up on the Declined Synonyms tab.

Did you find this page helpful?