Skip to content

docs: note data apps limitation in preview environments #647

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

Open
mintlify wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: note data apps limitation in preview environments #647

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
b7b5ea4
docs: note data apps limitation in preview environments
mintlify[bot] May 18, 2026
4673657
docs: link to dedicated preview environments guide
mintlify[bot] May 18, 2026
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
15 changes: 15 additions & 0 deletions guides/data-apps.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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](/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:

- **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
Expand Down
Loading