From 721a5c64a66bb74be3b2273c52835b9b0903f17d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 22 May 2026 08:05:04 +0000 Subject: [PATCH] docs: document dashboard refresh behavior for data app tiles --- guides/data-apps.mdx | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/guides/data-apps.mdx b/guides/data-apps.mdx index 296ce7df..d090c1a6 100644 --- a/guides/data-apps.mdx +++ b/guides/data-apps.mdx @@ -118,6 +118,16 @@ Personal apps stay tied to whoever created them until they're moved into a space ![Clean Shot 2026 04 29 At 18 39 56@2x](/images/CleanShot-2026-04-29-at-18.39.56@2x.png) +### Adding an app to a dashboard + +You can add a data app to a dashboard the same way you add a chart — pick it from the **Add tile** menu. The app renders inside the tile and runs its queries against the same project, with the dashboard's filters applied. + +A few things to know about data app tiles on dashboards: + +- **Dashboard filters apply.** Filters set on the dashboard are forwarded to the app and stamped onto the metric queries it runs, so the tile reflects the same filtered view as the chart tiles next to it. +- **The dashboard refresh button refreshes the tile.** Pressing the dashboard's refresh button reloads the data app tile and bypasses the warehouse results cache for the queries it re-runs, matching how chart tiles behave. Use it when you want the app to show fresh data without reloading the whole page. +- **Permissions still apply.** Whoever views the dashboard sees data based on their own role and user attributes. For embedded dashboards, data app tiles only render when the embed JWT enables [`canViewDataApps`](/references/embedding#view-data-apps). + ## Data context and the app model Data apps don't ship with their own copy of your data. They run inside a sandboxed iframe with no direct access to the Lightdash API, so every query the app wants to run is proxied through the Lightdash UI hosting the iframe.