From 9553ebb2036549fe2e30ff151e2050e9eb3b1da0 Mon Sep 17 00:00:00 2001 From: Tatiana Inama Date: Wed, 9 Sep 2026 16:37:29 +0100 Subject: [PATCH] docs(nested-columns): state the minimum CLI version and the not-unnested warning --- semantic-layer/nested-and-repeated-columns.mdx | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/semantic-layer/nested-and-repeated-columns.mdx b/semantic-layer/nested-and-repeated-columns.mdx index 21665179..511de9c2 100644 --- a/semantic-layer/nested-and-repeated-columns.mdx +++ b/semantic-layer/nested-and-repeated-columns.mdx @@ -204,7 +204,9 @@ models: ## Deploy and generate -Explores compile in the CLI during [`lightdash deploy`](/workflow/cli/deploy), and the CLI reads the nested-column setting from the Lightdash server. Before deploying, [update the Lightdash CLI](/workflow/cli/install#updating-the-lightdash-cli). If the CLI cannot reach the server or read the setting, it compiles with nested-column support disabled and silently drops repeated leaves from the Explore. +Explores compile in the CLI during [`lightdash deploy`](/workflow/cli/deploy), and the CLI reads the nested-column setting from the Lightdash server. Nested-column support needs Lightdash CLI 2.153.0 or later, so [update the Lightdash CLI](/workflow/cli/install#updating-the-lightdash-cli) before deploying. If the CLI cannot reach the server or read the setting, it prints a warning and compiles with nested-column support disabled. + +When a model documents fields under a repeated column but they were not unnested, because the setting is off for your organization or the deploy came from an older CLI, the deploy output, the Explore and the [validation page](/workflow/validating-your-content) show a warning naming the model and the affected fields. Selecting one of those fields fails on BigQuery until you enable the setting or upgrade the CLI and deploy again. On self-hosted deployments, add `unnest-repeated-columns` to `LIGHTDASH_ENABLE_FEATURE_FLAGS`; see [Feature flags](/self-host/customize-deployment/environment-variables#feature-flags).