# Synonyms

You can set up synonyms via the Console. When your user searches for a word, the results for its synonyms are also added to the result set.

For example, if you own a travel website and want to display search results for 'New York City' when a customer searches for ‘NYC’, then add a synonym.

#### Adding Synonyms <a href="#adding-synonyms" id="adding-synonyms"></a>

* Select [Synonyms](https://app.search.io/collection/synonyms) from the left menu
* Click 'Create Synonym'.
* Enter the term you expect people to search for
* Enter the term that you also want to display results for when people search for the above term
* Define whether you want to give equal, more, or less importance to the original term or the synonym.

![](https://3882858970-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FVeIbtsTcQaqaNeKzLbbU%2Fuploads%2F7jYJ6R70uroXxO6C8Hn2%2Fsynonym-nyc.png?alt=media\&token=66b4d1af-eefb-4672-87b5-80cb594e1131)

**One directional**

Synonyms work in one direction (also referred to as uni-directional). This means that in the example above, searching for 'NYC' will display results for 'New York City' as well. However, searching for 'New York City' will not display results for 'NYC' unless you set up an additional synonym.

**One to one**

Synonyms are a one to one mechanism, so a search for 'cot' would require the creation of a synonym for 'bassinet' and a second synonym created for 'crib'&#x20;

**Ranking importance for synonyms**

The synonym rule allows you to specify if you want to give synonym more importance than the original word when ranking search results. For example, assume the webpages of your site that contain the word 'New York City' are more important than the pages that only contains the word ‘NYC’. When creating a synonym, choose "More" option from the dropdown to make results for 'New York City' more important than results for ‘NYC’. It will then rank the pages that include the word 'New York City' higher for results where the scores were equal.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.search.io/documentation/fundamentals/search-settings/synonyms.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
