> ## Documentation Index
> Fetch the complete documentation index at: https://docs.paradime.io/llms.txt
> Use this file to discover all available pages before exploring further.

# dbt™ version upgrades

> Upgrade the dbt Core™ version your Paradime workspace runs on, one release at a time, with per-version guides and a DinoAI agent to do the prep work.

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](/products/settings/configuration/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](/products/settings/connections/index#create-and-manage-environments).
* dbt Labs commits to backward compatibility across all 1.x versions. Behavior changes ship behind [behavior change flags](https://docs.getdbt.com/reference/global-configs/behavior-changes) you set under `flags:` in `dbt_project.yml`, so you control when each change takes effect.

<Info>
  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.
</Info>

## Version guides

<CardGroup cols={2}>
  <Card title="Upgrade to dbt™ 1.9" href="/guides/migrations/dbt-version-upgrades/upgrade-to-dbt-1.9" icon="arrow-up">
    Microbatch incremental models, redesigned snapshots, and a Snowflake `target.account` breaking change.
  </Card>

  <Card title="Upgrade to dbt™ 1.10" href="/guides/migrations/dbt-version-upgrades/upgrade-to-dbt-1.10" icon="arrow-up">
    The `--sample` flag, plus the first wave of deprecation warnings that prepare your project for v2.
  </Card>

  <Card title="Upgrade to dbt™ 1.11" href="/guides/migrations/dbt-version-upgrades/upgrade-to-dbt-1.11" icon="arrow-up">
    User-defined functions (UDFs), `DBT_ENGINE_` environment variables, and deprecation warnings on by default.
  </Card>

  <Card title="Upgrade to dbt™ 1.12" href="/guides/migrations/dbt-version-upgrades/upgrade-to-dbt-1.12" icon="arrow-up">
    The opt-in v2 Rust parser, native private packages, `vars.yml`, and a large batch of behavior flags flipping on.
  </Card>

  <Card title="Prepare for dbt™ v2" href="/guides/migrations/dbt-version-upgrades/prepare-for-dbt-v2" icon="rocket">
    What the v2 engine removes and changes, and how to get a 1.x project v2-ready today.
  </Card>

  <Card title="Upgrade with the DinoAI agent" href="/guides/migrations/dbt-version-upgrades/upgrade-with-the-dinoai-agent" icon="bot">
    Let an agent find and fix deprecations, validate the project on the target version, and open the PR.
  </Card>
</CardGroup>

## Related guides

<CardGroup cols={2}>
  <Card title="Change the workspace dbt™ version" href="/guides/upgrade-dbt-core-version" icon="settings">
    The Settings walkthrough for switching versions once your project is ready.
  </Card>

  <Card title="Official dbt™ upgrade guides" href="https://docs.getdbt.com/docs/dbt-versions/core-upgrade" icon="external-link">
    The upstream dbt Core™ upgrade documentation these guides are based on.
  </Card>
</CardGroup>


## Related topics

- [dbt™ version upgrades](/guides/migrations/dbt-version-upgrades/index.md)
- [Upgrade dbt Core™ version](/guides/upgrade-dbt-core-version.md)
- [Upgrade with the DinoAI agent](/guides/migrations/dbt-version-upgrades/upgrade-with-the-dinoai-agent.md)
- [Migrations](/guides/migrations/index.md)
- [Upgrade to dbt™ 1.9](/guides/migrations/dbt-version-upgrades/upgrade-to-dbt-1.9.md)