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

# Export and import indices and settings

> Export and your records and settings from your Algolia index from the dashboard or the API.

export const Records = () => <Tooltip tip="A record is a searchable object in an Algolia index. Each record consists of named attributes." cta="Algolia records" href="/doc/guides/sending-and-managing-data/prepare-your-data#algolia-records">
    records
  </Tooltip>;

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>;

An Algolia index has <Records /> and configuration data, including settings, synonyms, and rules.
Exporting your records and configuration can be useful when you need to:

* Back up your index.
* Track changes to the index configuration (for example, with a version control system).
* Apply the same configuration to multiple indices. For example,
  in staging and production environments,
  or if you use different indices for different geographical regions.

## Export and import records

To **export your records** as a JSON file, use one of these options:

* Algolia CLI: [`algolia objects browse`](/doc/tools/cli/commands/objects/browse)
* API clients: [`browse`](/doc/libraries/sdk/v1/methods/browse)

You can't export records from the Algolia dashboard.

For information about importing or **uploading your records**,
see [Send and update your data](/doc/guides/sending-and-managing-data/send-and-update-your-data).

## Export and import index configurations

Your index configuration includes:

* Settings, such as:

  * [Searchable attributes](/doc/guides/managing-results/must-do/searchable-attributes)
  * [Custom ranking](/doc/guides/managing-results/must-do/custom-ranking)
  * [Typo tolerance](/doc/guides/managing-results/optimize-search-results/typo-tolerance/in-depth/configuring-typo-tolerance)
  * [Stop words](/doc/guides/managing-results/optimize-search-results/handling-natural-languages-nlp/how-to/customize-stop-words)

* [Synonyms](/doc/guides/managing-results/optimize-search-results/adding-synonyms)

* [Rules](/doc/guides/managing-results/rules/rules-overview)

### Export index configuration in the Algolia dashboard

To export the configuration of an index from the Algolia dashboard as a JSON file:

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. Select **Manage index > Export Configuration**.
5. Select what you want to export: **Settings**, **Synonyms**, or **Rules**.
6. Click **Export Configuration** to download a JSON file with the index configuration.

### Export index configuration with the Algolia CLI

With the **Algolia CLI**, you can export an index configuration with the
[`algolia indices config export`](/doc/tools/cli/commands/indices/config/export) command.

This creates a JSON file that you can [import](#import-index-configuration-in-the-algolia-dashboard)
in the dashboard, for example, for another index.

To export your settings, rules, or synonyms individually, use these commands:

* [`algolia settings get`](/doc/tools/cli/commands/settings/get)
* [`algolia rules browse`](/doc/tools/cli/commands/rules/browse)
* [`algolia synonyms browse`](/doc/tools/cli/commands/synonyms/browse)

Check the [Algolia CLI examples](/doc/tools/cli/examples#export-your-algolia-data) for more information.

### Export index configuration with the API

With the API clients,
you can export your index settings, rules, and synonyms, using these methods:

* [`getSettings`](/doc/libraries/sdk/v1/methods/get-settings)
* [`exportRules`](/doc/libraries/sdk/v1/methods/export-rules)
* [`exportSynonyms`](/doc/libraries/sdk/v1/methods/export-synonyms)

### Import index configuration in the Algolia dashboard

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. Select **Manage index > Import Configuration**.
5. Select the JSON file you want to import.
6. Choose what you want to import: **Settings**, **Synonyms**, or **Rules**.
7. Type `IMPORT` to confirm and click **Import Configuration**.

<Warning>
  Importing settings **replaces all existing index settings** with the imported ones.
  Synonyms and rules are replaced if a synonym or rule with the same `objectID` already exists.
  Otherwise, new synonyms or rules are added.
</Warning>

### Import index configuration with the Algolia CLI

To import the configuration of an index with the Algolia CLI,
use the [`algolia indices config import`](/doc/tools/cli/commands/indices/config/import) command.
The command expects a JSON file with `"settings"`, `"rules"`, or `"synonyms"` keys,
which you can get by exporting an index configuration from the dashboard or with the Algolia CLI.

To import settings, rules, or synonyms individually, use these commands:

* [`algolia settings import`](/doc/tools/cli/commands/settings/import)
* [`algolia rules import`](/doc/tools/cli/commands/rules/import)
* [`algolia synonyms import`](/doc/tools/cli/commands/synonyms/import)

Check the [Algolia CLI examples](/doc/tools/cli/examples#import-your-algolia-data) for more information.

### Import index configuration with the API

With the API clients, you can use these methods for importing settings, rules, or synonyms into your index:

* [`setSettings`](/doc/libraries/sdk/v1/methods/set-settings)
* [`saveRule`](/doc/libraries/sdk/v1/methods/save-rule)
* [`saveSynonym`](/doc/libraries/sdk/v1/methods/save-synonym)