Skip to main content
Paradime runs one dbt Core™ version per workspace (with optional per-environment overrides), so upgrading is a two-part job: prepare your project for the new version’s changes, then switch the version in Settings. These guides give you the per-version preparation, faithfully condensed from the official dbt™ upgrade guides, plus a DinoAI agent that can do the preparation for you.

How versions work in Paradime

  • The workspace dbt™ version applies to every user across the Code IDE, Bolt, and the catalog. Admins change it in Settings > Workspace > General. See Manage dbt™ version.
  • Bolt and Agent environments can pin their own version instead of inheriting the workspace default, which lets you test a new version in a dedicated environment before rolling it out. See Create and manage environments.
  • dbt Labs commits to backward compatibility across all 1.x versions. Behavior changes ship behind behavior change flags you set under flags: in dbt_project.yml, so you control when each change takes effect.
Upgrade one minor version at a time and read that version’s guide before you switch. Each release enables behavior flags introduced in earlier releases by default, so skipping versions compounds the changes you absorb at once.

Version guides

Upgrade to dbt™ 1.9

Microbatch incremental models, redesigned snapshots, and a Snowflake target.account breaking change.

Upgrade to dbt™ 1.10

The --sample flag, plus the first wave of deprecation warnings that prepare your project for v2.

Upgrade to dbt™ 1.11

User-defined functions (UDFs), DBT_ENGINE_ environment variables, and deprecation warnings on by default.

Upgrade to dbt™ 1.12

The opt-in v2 Rust parser, native private packages, vars.yml, and a large batch of behavior flags flipping on.

Prepare for dbt™ v2

What the v2 engine removes and changes, and how to get a 1.x project v2-ready today.

Upgrade with the DinoAI agent

Let an agent find and fix deprecations, validate the project on the target version, and open the PR.

Change the workspace dbt™ version

The Settings walkthrough for switching versions once your project is ready.

Official dbt™ upgrade guides

The upstream dbt Core™ upgrade documentation these guides are based on.