Skip to content

Add dbt versions explainer to Upgrading dbt - #1739

Merged
jpetey75 merged 4 commits into
mainfrom
cloudy/docs-2026-11-12-change-0e7724e5209f5220
Nov 19, 2026
Merged

jpetey75 merged 4 commits into
mainfrom
cloudy/docs-2026-11-12-change-0e7724e5209f5220

Conversation

@lightdash-bot

@lightdash-bot lightdash-bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Collaborator

The page described dbt v2 only as "dbt Core v2 (Fusion)", which blurred two distributions, and readers couldn't tell which dbt versions Lightdash compiles with or detects.

  • New dbt versions table: dbt Core 1.x, dbt v2 (dbt Product License) and dbt OSS v2 (Apache 2.0), and how Lightdash compiles each
  • Git connections use the project's dbt version; the CLI uses local dbt and detects dbt-oss from CLI 3.209.1
  • Fusion heading renamed to Moving to dbt v2 (Fusion); old anchor kept with an <a id>
  • Tidies the read-only advice on Connect a project

Checked against SupportedDbtVersions (packages/common), getDbtVersion.ts (packages/cli, lightdash#32374), and dbt Labs' dbt and dbt OSS post.

Review this PR individually. Close it to reject this change, then ask Cloudy to restack before merging.

@github-actions

github-actions Bot commented Nov 12, 2026 •

Copy link
Copy Markdown
Contributor

Documentation validation

✅ All blocking checks passed.

Component system

70 finding(s) across the corpus. Largest: heading.question 24 · prose.filler-word 23 · prose.anchor-index 13 · heading.overview 9 · prose.interface-narration 1.

Findings on lines this pull request touched are annotated inline in Files changed.

View the validation run.

@mintlify

mintlify Bot commented Nov 19, 2026 •

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated
lightdash 🟢 Ready View Preview Nov 19, 2026, 8:56 PM

💡 Tip: Enable Automations to automatically generate PRs for you.

@jpetey75
jpetey75 force-pushed the cloudy/docs-2026-11-12-change-0e7724e5209f5220 branch from 2b9dcb9 to 05fc065 Compare November 19, 2026 20:45
@jpetey75
jpetey75 force-pushed the cloudy/docs-2026-11-12-change-0e7724e5209f5220 branch from 05fc065 to 7e15773 Compare November 19, 2026 20:48
Base automatically changed from cloudy/docs-2026-11-12-change-80d3cc67b4e9f129 to main November 19, 2026 20:49
Cloudy and others added 3 commits November 19, 2026 12:49
- Drop the v1.10-1.13 maintenance claim (1.13 is in beta) and the
  'engine is not gated' line (dbt v2 is under the dbt Product License)
- One table instead of two lists and a callout
- Rename the Fusion heading, keep the old anchor

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- Name warehouses and connection types instead of linking every section
- Plain read-only recommendation

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

## 1. Connect to a warehouse

We currently support [BigQuery](#bigquery), [Postgres](#postgres), [Supabase](#supabase), [Redshift](#redshift), [Snowflake](#snowflake), [Databricks](#databricks), [Trino](#trino), [ClickHouse](#clickhouse), [DuckDB](#duckdb), and [Athena](#athena). If your warehouse isn't listed, you may still be able to connect to it through [Trino](#trino).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why are we getting rid of the links here? let's keep them

The **dbt version** field sets the dbt Core 1.x version Lightdash uses when it compiles your project. Lightdash supports dbt Core 1.4 to 1.12. The default, **latest**, uses the newest version Lightdash supports, currently 1.12. If a refresh fails with a dbt compile error and the project is pinned to an older version, choose a newer version, or **latest**, and refresh again. `lightdash deploy` and `lightdash preview` compile with the dbt you have installed, so for those, upgrade dbt locally. The list has no dbt Core v2 (Fusion) option: for a Fusion project, keep **latest** and keep the project compatible with dbt Core 1.10 or later, as described in [Moving to dbt Core v2 (Fusion)](/integrations/dbt/upgrading#moving-to-dbt-core-v2-fusion).
The **dbt version** field sets the dbt Core 1.x version Lightdash uses when it compiles your project. Lightdash supports dbt Core 1.4 to 1.12. The default, **latest**, uses the newest version Lightdash supports, currently 1.12. If a refresh fails with a dbt compile error and the project is pinned to an older version, choose a newer version, or **latest**, and refresh again. `lightdash deploy` and `lightdash preview` compile with the dbt you have installed, so for those, upgrade dbt locally. The list has no dbt v2 option: for a dbt v2 project, keep **latest** and keep the project compatible with dbt Core 1.10 or later, as described in [Moving to dbt v2](/integrations/dbt/upgrading#moving-to-dbt-v2-fusion).

Pick your connection type and follow the guide below: [GitHub](#github), [GitLab](#gitlab), [Azure DevOps](#azure-devops), [Bitbucket](#bitbucket), [dbt Cloud](#dbt-cloud), or the [CLI](#cli).

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

keep links here too

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jpetey75
jpetey75 merged commit 6e5b40b into main Nov 19, 2026
10 of 14 checks passed
@jpetey75
jpetey75 deleted the cloudy/docs-2026-11-12-change-0e7724e5209f5220 branch November 19, 2026 21:08

This branch was successfully deployed

1 active deployment
staging — 49fd2dda Deployed Nov 19, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants