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.

Algolia Academy

Dynamic Synonym Suggestions

Get started

Dynamic Synonym Suggestions are available on Build and Premium plans.

To activate Dynamic Synonym Suggestions for one of your indices:

1

Select your Algolia application

Go to the Algolia dashboard and select your Algolia application.

2

Select Search

On the left sidebar, select

Search.

3

Select your index

Select your Algolia index:

4

Activate AI synonyms

Open the AI Synonyms page and select Activate for this index.

Send 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.

Each suggestion shows more information, such as a confidence score. If you’re sending click and conversion events, you can compare click-through and conversion rates for both alternatives.

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 multiple suggestions for the same search query. To see the alternative suggestions, click More suggestions.

Further reading