> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://help.sigmacomputing.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://help.sigmacomputing.com/_mcp/server.

# Manage workbook refresh options

> Set a custom refresh schedule to refresh document data on a schedule without user interaction.

Sigma refreshes workbook data every time an individual opens or refreshes the workbook. If you want to refresh workbook data on a set schedule, such as for a workbook displayed on a screen without user interaction, you can set a custom refresh schedule.

You can also refresh data elements individually, but not on an automated schedule.

Sigma does not store data. Every refresh re-queries the data in the warehouse. Setting an auto-refresh can burden the connection and result in significant warehouse costs.

## Requirements

* To set up a refresh schedule, you must have **Can Edit** [access](/docs/folder-and-document-permissions#document-permissions) to the individual workbook and you must be assigned an account type with the **Set workbook data refresh** permission enabled.
* If your workbook is embedded in a host application, the secure embed must be authenticated with a JSON Web Token (JWT) for a custom refresh schedule to apply to the embedded content. See [Create an embed API with JSON Web Tokens](/docs/create-an-embed-api-with-json-web-tokens).

## Set up a refresh schedule

To set up a refresh schedule for a workbook, do the following:

1. Click the down arrow (<img src="https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/caret.svg" alt="" />) **More options** next to the refresh button in the workbook header.
2. Select **Data refresh**.

   The **Data refresh settings** modal opens.
3. For **Refresh schedule**, turn on the **Enable** toggle.
4. Adjust the **Query data every** field to specify how often to refresh the workbook. For example, every 10 minutes.
5. (Optional) To limit the refresh schedule to a specific time window, enter times in the **Between** fields. Sigma uses the browser timezone to evaluate whether the refresh schedule is in effect.
6. Click **Save**.

## Refresh individual data elements

You can manually refresh the data in an individual data element.

1. Select the data element.
2. In the element toolbar, click <img src="https://sigma-docs-screenshots.s3.us-west-2.amazonaws.com/Icons/more.svg" alt="" /> **More**.
3. Click **Refresh data**.

   The data in the element refreshes.

## Related resources

* [Set a query ID cache duration](/docs/set-a-query-id-cache-duration)
* [Caching and data freshness](/docs/caching-and-data-freshness)