Data Refresh

Control how and when your widget checks for updated data from your data source.

Refresh Modes

There are two data refresh modes, configurable in the Source tab under Data Refresh Mode.

On Widget Load (Default)

Data checks for updates when a visitor first opens the page.

1. The cached version loads immediately for fast performance
2. A background check runs to see if the data source has changed
3. If new data is found, the cache is updated
4. The next page load (or refresh) shows the updated data

This mode is best for most use cases — visitors get fast load times and data stays reasonably fresh.

Real-time

In addition to the on-load check, the widget automatically checks for new data every few minutes while visitors have it open.

• Checks happen periodically while the page is visible
• When the browser tab is hidden, checks pause automatically to save resources
• If updated data is found, the widget refreshes without the visitor needing to reload

This mode is useful for dashboards, live status boards, or any widget where visitors may keep the page open for extended periods.

Cache Refresh Rate

Regardless of which mode you choose, the cache refreshes at most once per minute. Even if multiple visitors load your widget simultaneously, only one data check runs. This prevents excessive requests to your data source while keeping updates flowing quickly.

Forcing a Refresh

Republishing your widget immediately clears the cache. The next visitor will see the latest data from your data source.

Where to Configure

1. Open your widget in the editor
2. Go to the Source tab
3. Find the Data Refresh Mode dropdown
4. Select On widget load or Real-time

Related

• Data Sources — Connect to Google Sheets, Airtable, Notion, and more
• Managing Connections — Rename, delete, and view linked widgets for your connections