Skip to content

docs: document data app tiles on dashboards #688

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

Closed
mintlify wants to merge 1 commit into from
Closed

docs: document data app tiles on dashboards #688

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
10 changes: 10 additions & 0 deletions guides/data-apps.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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)
</Frame>

### 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.
Expand Down
Loading