Skip to content

docs: document data app preview refresh and cache invalidation #689

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Spissable merged 1 commit into from
May 22, 2026
Merged

docs: document data app preview refresh and cache invalidation #689

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions guides/data-apps.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,14 @@ When an app runs a query, it will appear in the query inspector. Open it to see
![Clean Shot 2026 04 29 At 18 38 42@2x](/images/CleanShot-2026-04-29-at-18.38.42@2x.png)
</Frame>

### Refreshing the preview

The preview header has a **Refresh** button that reloads the app's iframe and re-runs every metric query against the warehouse, without starting a new build. Use it when you've changed something in your semantic layer (for example, pushed a dbt update) and want to see the new results in the running preview.

Refreshing also **invalidates the warehouse cache** for that app. The first time you refresh, the app stops serving cached query results and re-queries the warehouse fresh from then on - the same behaviour as the refresh button on a dashboard. The initial load still uses cache so the app opens quickly; once you've asked for fresh data, every subsequent query stays fresh for the rest of the session.

You'll find the same **Refresh** action in the **⋯** menu on the standalone preview page (the full-screen view you get from **Continue building**).

## Sharing an app

Newly created apps are personal - only you can see them. Apps will initially appear in **Settings \> My apps.** To share an app with your team, add it to a space.
Expand Down
Loading