---
title: "document-refresh"
description: "../../../server/clustering/replication/change-vector---"
url: "https://docs.ravendb.net/6.2/studio/database/settings/document-refresh"
version: "6.2"
---

# document-refresh

> 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."

../../../server/clustering/replication/change-vector---
title: "Document Refresh"
sidebar\_label: Document Refresh
sidebar\_position: 7
--------------------

## Document Refresh

> **Note**
>
> - Use this view to configure the **Document Refresh** feature.
> - Documents can be scheduled for refresh by a `@refresh` property in their `@metadata`.
> - When the document refresh feature is enabled, it routinely checks for documents that
>   include the `@refresh` property and refreshes them on the scheduled time.  
>   When a document is refreshed its [change vector](https://docs.ravendb.net/6.2/server/clustering/replication/change-vector.md)
>   is incremented, triggering its re-indexation and other features that react to document updates.
> - Documents are refreshed only once: after refreshing a document, the refresh feature removes
>   the `@refresh` property from its `@metadata`.
> - Learn more about this option [here](https://docs.ravendb.net/6.2/server/extensions/refresh.md).

## Document Refresh View

![Document Refresh View](https://docs.ravendb.net/assets/images/document-refresh-454ac497b9673e56582ace3c7d17a5f1.png)

1. **Document Refresh**  
   Click to configure document refresh.

2. **Document Refresh Configuration**
   - **Enable Document Refresh**  
     Toggle this option to enable or disable the refresh feature for the selected database.
   - **Set refresh frequency**  
     Set the frequency at which the server scans for documents scheduled for refresh.  
     Default value: *60 seconds*
   - **Set max number of documents to process in a single run**  
     Set the maximal number of documents the feature is allowed to refresh in one run.
   - **Save**  
     Changes in the configuration will apply only after saving them.

3. **Set the `@refresh` property**
   - Add a `@refresh` property to the `@metadata` of each document that you want to schedule refresh for.
   - Set the refresh time in UTC format, e.g. - `"@refresh": "2025-04-22T08:00:00.0000000Z"`
