> ## Documentation Index
> Fetch the complete documentation index at: https://algolia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Manage synonyms in the dashboard

> Learn how to manage synonyms in the Algolia dashboard

export const Application = () => <Tooltip tip="An Algolia application is a self-contained environment with its own indices, configuration, and API keys. Applications don't share data or settings with each other.">
    application
  </Tooltip>;

export const AlgoliaSearch = () => <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80" width="20" height="20" className="inline" fill="none" role="presentation" ariaLabel="Algolia Search">
    <circle cx="40" cy="32" r="28" fill="#5468FF"></circle>
    <rect x="30" y="22" width="20" height="20" rx="10" fill="#fff"></rect>
    <path d="M43 63.5 54.5 60l6 17h-12L43 63.5Z" fill="#36395A"></path>
  </svg>;

To add, delete, or edit synonyms in the Algolia dashboard, follow these steps:

1. Go to the [Algolia dashboard](https://dashboard.algolia.com/explorer/browse) and select your Algolia <Application />.
2. On the left sidebar, select <AlgoliaSearch /> **Search**.
3. Select your Algolia index.
4. On the **Configuration** tab, click **Synonyms**.

## Add synonyms

To add a new synonym, click **Add Synonyms** and choose the type:

* Regular synonyms
* One-way synonyms
* Alternative corrections
* Placeholders

### Synonyms (regular synonyms)

<img src="https://mintcdn.com/algolia/AACpGv43fS_1tsyy/images/guides/full-text-search/regular-synonyms.jpg?fit=max&auto=format&n=AACpGv43fS_1tsyy&q=85&s=c4c87c51ed3d6a6e91f33c4fd20f4301" alt="Adding three equivalent terms for a regular synonym." width="1097" height="1003" data-path="images/guides/full-text-search/regular-synonyms.jpg" />

In the **Synonyms** field,
enter your [regular synonyms](/doc/guides/managing-results/optimize-search-results/adding-synonyms#regular-synonyms):
a comma-separated list of words or expressions that should be considered equivalent.

### One-way synonyms

<img src="https://mintcdn.com/algolia/AACpGv43fS_1tsyy/images/guides/full-text-search/one-way-synonyms.jpg?fit=max&auto=format&n=AACpGv43fS_1tsyy&q=85&s=2b2195675bb604dea5ca9f55aa677fa6" alt="Screenshot of a dialog to add an expansion with 'One-way Synonyms' selected, showing 'top' as the search term and 'hoodie' and 'sweater' as alternatives." width="1096" height="1190" data-path="images/guides/full-text-search/one-way-synonyms.jpg" />

In the **Search term** field,
enter your [one-way synonym](/doc/guides/managing-results/optimize-search-results/adding-synonyms#one-way-synonyms):
the text used in a query that should be substituted by the comma-separated list of terms in the **Alternatives** field ("top" and "hoodie"/"sweater" in the example).

### Placeholders

<img src="https://mintcdn.com/algolia/AACpGv43fS_1tsyy/images/guides/full-text-search/placeholders.jpg?fit=max&auto=format&n=AACpGv43fS_1tsyy&q=85&s=1da47c535aeead1da141e9851ce37aaa" alt="Screenshot of a form to add an expansion with 'Placeholders' selected, a placeholder field, and 'street' and 'st' in replacements." width="1095" height="1191" data-path="images/guides/full-text-search/placeholders.jpg" />

In the **Placeholder** field,
enter your [placeholder synonym](/doc/guides/managing-results/optimize-search-results/adding-synonyms#placeholders):
the text, enclosed in angle brackets, used by any query matching one of the **Replacements** (`<street>` for `street` and `st`, in the example).

### Alternative corrections

<img src="https://mintcdn.com/algolia/AACpGv43fS_1tsyy/images/guides/full-text-search/alternative-corrections.jpg?fit=max&auto=format&n=AACpGv43fS_1tsyy&q=85&s=e275f40d5f50f596c621ef43a5295160" alt="Adding an alternative correction for a search term." width="1098" height="1347" data-path="images/guides/full-text-search/alternative-corrections.jpg" />

In the **Search term** field,
enter your [alternative corrections synonym](/doc/guides/managing-results/optimize-search-results/adding-synonyms#alternative-corrections):
the text used in the query that should be substituted by the comma-separated list of alternative words or expressions in the **Corrections** field (`tablet` for `ipad` in the example).

In the **Typo** field,
choose the number of typos allowed (1 or 2) when the search term matches one of the corrections.

## Copy synonyms to other indices

To copy a synonym you created to other indices,
select the **Copy this expansion to other indices** option and choose your indices.

## Import synonyms from a file

To import synonyms from a file, click the arrow next to **Add Synonyms** and then click **Upload**.

<img src="https://mintcdn.com/algolia/AACpGv43fS_1tsyy/images/guides/full-text-search/upload-synonyms.jpg?fit=max&auto=format&n=AACpGv43fS_1tsyy&q=85&s=30f45dc0bc9c045002731e38053430a5" alt="Screenshot of the synonym upload dialog for index 'an index name', showing supported JSON and CSV formats and a code example." width="1099" height="1140" data-path="images/guides/full-text-search/upload-synonyms.jpg" />

JSON and CSV are the two supported data formats,
but CSV is limited to regular synonyms.

### Import synonyms from JSON icon=braces

The file must contain an array of newline-delimited JSON objects.
Each object must include:

* A **unique object ID** value that identifies the synonym record.
  Object ID aren't automatically generated if they're missing.

* A **type** value, which must be one of these options:

  * `synonym`
  * `oneWaySynonym`
  * `altCorrection1`
  * `altCorrection2`
  * `placeholder`

* Other fields required by [the selected type](#add-synonyms).

### Import synonyms from CSV

You can only use CSV files to import regular synonyms (`synonym`).
The file must contain one set of **comma-separated** synonyms per line.

Algolia accepts CSV files which must use commas as field separators.

## Export synonyms to a file

To back up or take a snapshot of your synonyms,
click the arrow next to **Add Synonyms** and click **Export as JSON** or **Export as CSV**.
CSV export is limited to regular synonyms.

## Delete one synonym

To delete a specific synonym,
click <Icon icon="trash" /> **Delete synonym**.

<img src="https://mintcdn.com/algolia/AACpGv43fS_1tsyy/images/guides/full-text-search/delete-a-synonym.jpg?fit=max&auto=format&n=AACpGv43fS_1tsyy&q=85&s=1f207e4aafc6ef8fb57b36feb2dd47c6" alt="Screenshot of a table showing synonym management with a 'Delete synonym' tooltip over the trash icon next to a 'One-way Synonym' entry." width="1613" height="512" data-path="images/guides/full-text-search/delete-a-synonym.jpg" />

## Delete all synonyms

To remove all synonyms from an index,
open the <Icon icon="chevron-down" /> **More Options** menu and select **Delete All**.

<Warning>
  You can't undo this operation.
</Warning>

Check **Delete all these expansions on other indices** to propagate the deletion to all chosen indices.

## Edit synonyms

Click <Icon icon="square-pen" /> **Edit synonym**.

<img src="https://mintcdn.com/algolia/AACpGv43fS_1tsyy/images/guides/full-text-search/edit-synonym.jpg?fit=max&auto=format&n=AACpGv43fS_1tsyy&q=85&s=8616b0f38caa4d991547874eac14b5f1" alt="Screenshot of a table showing synonym types and expansions, with an 'Edit synonym' tooltip over the edit icon for a synonym entry." width="1573" height="543" data-path="images/guides/full-text-search/edit-synonym.jpg" />
