From 2c8f84da54deee61033e79cc6de49d55ffd781ef Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 22 May 2026 08:24:13 +0000 Subject: [PATCH] docs: document data app preview refresh and cache invalidation --- guides/data-apps.mdx | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/guides/data-apps.mdx b/guides/data-apps.mdx index 296ce7df..3fb683d1 100644 --- a/guides/data-apps.mdx +++ b/guides/data-apps.mdx @@ -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) +### 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.