From b7b5ea405453f2585bd433685b2a0cb7f687e0be Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 18 May 2026 10:35:21 +0000 Subject: [PATCH 1/2] docs: note data apps limitation in preview environments --- guides/data-apps.mdx | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/guides/data-apps.mdx b/guides/data-apps.mdx index 0af42fc9..2a157244 100644 --- a/guides/data-apps.mdx +++ b/guides/data-apps.mdx @@ -94,6 +94,21 @@ This means: - **Reference existing charts and dashboards.** Pointing the agent at a working metric query is faster and more reliable than describing the query in prose. - **Use the query inspector early.** If something looks off, check the queries the app is running before tweaking the prompt. +## Limitations + +### Preview environments and content promotion + +Data apps are not yet duplicated into [developer preview projects](/get-started/develop-in-lightdash/adding-tables-to-lightdash) or remapped during content promotion between projects. Dashboard tiles that embed a data app are still copied, but the tile keeps pointing at the original app rather than getting its own copy. + +In practice, this means: + +- **Opening a preview.** If you have access to the source project's app, the data app tile renders normally inside the preview dashboard. If you don't, the tile shows a "Data app not available" placeholder and the rest of the dashboard renders as expected. +- **Iterating inside a preview.** Not supported. Preview projects don't get their own copy of the app, so you can't open it from the app editor inside the preview. Keep iterating on the source project's app. +- **Promoting a dashboard from a preview back to the source project.** Works as expected. The tile already points at the source project's app, so the promote completes successfully. +- **Promoting between unrelated projects.** Data app tiles can be promoted, but the tile keeps referencing the downstream project's app — the same read-through behavior as previews. + +Full duplication of apps into previews and remapping during cross-project promotion is on the roadmap. + ## Troubleshooting ### "Breaking Browser Locker Behavior detected" error From 467365738c054a4599c0715d5c9a410bccb325bf Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 18 May 2026 10:36:35 +0000 Subject: [PATCH 2/2] docs: link to dedicated preview environments guide --- guides/data-apps.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/data-apps.mdx b/guides/data-apps.mdx index 2a157244..26be322b 100644 --- a/guides/data-apps.mdx +++ b/guides/data-apps.mdx @@ -98,7 +98,7 @@ This means: ### Preview environments and content promotion -Data apps are not yet duplicated into [developer preview projects](/get-started/develop-in-lightdash/adding-tables-to-lightdash) or remapped during content promotion between projects. Dashboard tiles that embed a data app are still copied, but the tile keeps pointing at the original app rather than getting its own copy. +Data apps are not yet duplicated into [developer preview projects](/guides/cli/how-to-use-lightdash-preview) or remapped during content promotion between projects. Dashboard tiles that embed a data app are still copied, but the tile keeps pointing at the original app rather than getting its own copy. In practice, this means: