From 58539d4a15f9e3d263d33bd4ae312ad671d425db Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Mon, 9 Feb 2026 12:25:12 +0000 Subject: [PATCH 1/2] Update guides/developer/dbt-model-best-practices.mdx Co-Authored-By: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com> --- guides/developer/dbt-model-best-practices.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/developer/dbt-model-best-practices.mdx b/guides/developer/dbt-model-best-practices.mdx index cb68a2d5..ee2e0d98 100644 --- a/guides/developer/dbt-model-best-practices.mdx +++ b/guides/developer/dbt-model-best-practices.mdx @@ -146,7 +146,7 @@ Pre-join data in your dbt models rather than joining at query time. As discussed ### Limit models exposed to the BI layer -Only surface production-ready models to end users: +Only expose production-ready, optimized models to your users in Lightdash. Staging models, intermediate transformations, and work-in-progress tables should remain hidden from end users to avoid confusion and ensure they're working with reliable, performant data. - **[dbt tags](/get-started/develop-in-lightdash/adding-tables-to-lightdash#limiting-the-tables-in-lightdash-using-dbt-tags)**: Control which models appear in Lightdash - **[User attributes](/references/workspace/user-attributes)**: Restrict model access by role From fee4d4665cafa15776b81a70f4c7920fc86f0b7f Mon Sep 17 00:00:00 2001 From: Jess Hitchcock Date: Mon, 9 Feb 2026 12:27:28 +0000 Subject: [PATCH 2/2] Update guidance on exposing models to BI layer Clarified that work-in-progress tables should also remain hidden from end users. --- guides/developer/dbt-model-best-practices.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/guides/developer/dbt-model-best-practices.mdx b/guides/developer/dbt-model-best-practices.mdx index ee2e0d98..03d0db4c 100644 --- a/guides/developer/dbt-model-best-practices.mdx +++ b/guides/developer/dbt-model-best-practices.mdx @@ -146,7 +146,7 @@ Pre-join data in your dbt models rather than joining at query time. As discussed ### Limit models exposed to the BI layer -Only expose production-ready, optimized models to your users in Lightdash. Staging models, intermediate transformations, and work-in-progress tables should remain hidden from end users to avoid confusion and ensure they're working with reliable, performant data. +Only expose production-ready, optimized models to your users in Lightdash. Staging models, intermediate transformations, work-in-progress and tables that are not yet optimized for query performance should remain hidden from end users to avoid confusion and ensure they're working with reliable, performant data. - **[dbt tags](/get-started/develop-in-lightdash/adding-tables-to-lightdash#limiting-the-tables-in-lightdash-using-dbt-tags)**: Control which models appear in Lightdash - **[User attributes](/references/workspace/user-attributes)**: Restrict model access by role