# Synonyms

Child route of the settings route.

Synonyms is an object containing words and their respective synonyms. A synonym in Meilisearch is considered equal to its associated word in a search query.

Synonyms can also be updated directly through the global settings route along with the other settings.

::: note
Updating the settings means overwriting the default settings of MeiliSearch. You can reset to default values using the DELETE routes.
:::

Learn more about synonyms

# Get synonyms

GET
/indexes/:index_uid/settings/synonyms

Get the list of synonyms of an index.

# Path Variables

Variable Description
index_uid The index UID

# Example

# Response: 200 OK

{
  "wolverine": ["xmen", "logan"],
  "logan": ["wolverine", "xmen"],
  "wow": ["world of warcraft"]
}

# Update synonyms

POST
/indexes/:index_uid/settings/synonyms

Update the list of synonyms of an index.

# Path Variables

Variable Description
index_uid The index UID

# Body

An object that contains all synonyms and their associated words.

More information about the body.

# Example

# Response: 202 Accepted

{
  "updateId": 1
}

This updateId allows you to track the current update.

# Reset synonyms

DELETE
/indexes/:index_uid/settings/synonyms

Reset the list of synonyms of an index to its default value.

# Default value

Empty object : {}

# Path Variables

Variable Description
index_uid The index UID

# Example

# Response: 202 Accepted

{
  "updateId": 1
}

This updateId allows you to track the current update.