---
title: "Index History"
description: "* An index revision is created for any change made to the index definition."
url: "https://docs.ravendb.net/6.2/studio/database/indexes/index-history"
version: "6.2"
---

# Index History

> RavenDB publishes an official agent skill for coding assistants at https://docs.ravendb.net/skills/ravendb/SKILL.md (also installable with `npx skills add ravendb/skills`). The skill describes itself as: "Read this before writing any RavenDB query, client call or /databases/ request. Covers server setup, document modelling, the Node.js, .NET and Python clients, RQL, indexes, vector search and AI agents. Code written from recall tends to run and return the wrong rows, because RQL resembles SQL and the clients take field names as plain strings."

## Index History

> **Note**
>
> - An index revision is created for any change made to the index definition.
>
> - By default 10 index revisions are kept. This number can be modified using
>   the [Database Settings view](#view-and-update-number-of-index-revisions)
>   or through [configuration](https://docs.ravendb.net/6.2/server/configuration/configuration-options.md).
>
> - The Index History dialog allows you to browse these revisions and revert
>   the current index definition to any of its past revisions.
>
> - You can revert only the 'Map and Reduce' methods or the full index definition.
>
> - In this page:
>   - [Open Index History Dialog](#open-index-history-dialog)
>   - [Index History Dialog](#index-history-dialog)
>   - [Select and Load an Index Revision](#select-and-load-an-index-revision)
>   - [View and Update Number of Index Revisions](#view-and-update-number-of-index-revisions)

## Open Index History Dialog

To open the index history dialog:

1. Open the **Indexes** > **List of Indexes** [view](https://docs.ravendb.net/6.2/studio/database/indexes/indexes-list-view.md).  
   ![Figure 1. List Of Indexes](https://docs.ravendb.net/assets/images/index-history-01-list-of-indexes-8f0e5229cb504e9581950d61b2aa90b5.png)
2. Select an Index.  
   ![Figure 2. Select Index](https://docs.ravendb.net/assets/images/index-history-02-select-index-ae2fb64868b6232f0f045ba316681ff6.png)
3. Open the Index History dialog.  
   ![Figure 3. Index History Button](https://docs.ravendb.net/assets/images/index-history-03-index-history-button-90051b90ab9f913dd9a3ca53b11b28df.png)

## Index History Dialog

![Figure 4. History Dialog](https://docs.ravendb.net/assets/images/index-history-04-history-view-3232a8e31c140fc152643d7b8fb4ea6f.png)

1. **Index History Dialog**
2. **Revisions List**  
   The history of changes made in this index, ordered by revision creation time.
3. **Index Definition Preview**  
   The full definition of the highlighted index revision, including not just its Map and
   Reduce sections but also all settings and field options.

## Select and Load an Index Revision

![Figure 5. Index Revision Selection](https://docs.ravendb.net/assets/images/index-history-05-index-revision-selection-69a227068703bba60e64e7244da3a759.png)

1. **Revisions List**  
   To preview a revision, hover over its creation date or select it using the arrow keys.

2. **Load Index Revision**  
   Click the Load Index button to load the previewed revision,  
   or click the creation time of any revision in the list to load it without preview.  
   ![Figure 6. Load Index](https://docs.ravendb.net/assets/images/index-history-06-load-map-and-reduce-only-38ab662584c4b71874224a434a84b3d0.png)

3. **Load Index Revision**  
   Click the Load Index button to load the previewed revision in its entirety,
   including its [field options](https://docs.ravendb.net/6.2/studio/database/indexes/create-map-index.md#index-field-options)
   and any additional settings.

4. **Load Map & Reduce Only**  
   Click the arrow and choose the "Load Map & Reduce Only" dropdown to load the selected
   revision's *Map and Reduce sections* only, leaving its other settings unchanged.

## View and Update Number of Index Revisions

The number of index revisions kept by the server can be modified through [configuration](https://docs.ravendb.net/6.2/server/configuration/configuration-options.md),  
or using the Database Settings view:

1. Open the **Settings** > **Database Settings** view.  
   ![Figure 7. Open Database Settings View](https://docs.ravendb.net/assets/images/index-history-07-open-database-settings-view-4d5a5ef10338000e55df6be8fafe2f96.png)
2. Enter **Indexing.History.NumberOfRevisions** in the search box to locate the
   index revisions number *Configuration Key* and see its current value.  
   ![Figure 8. Configuration Key and Value](https://docs.ravendb.net/assets/images/index-history-08-configuration-key-and-value-f100ad8b37710020a51871c6f8be9d65.png)
3. Click **Edit** to change the configuration key value.  
   ![Figure 9. Edit Value Key](https://docs.ravendb.net/assets/images/index-history-09-edit-value-key-dd8db4e094d96433f2b0d2ce07ae343f.png)
4. Edit the configuration key value and apply your changes.  
   ![Figure 10. Edit Value](https://docs.ravendb.net/assets/images/index-history-10-edit-value-07648c69b24a83fda44522d7cc5b7e75.png)
