> For AI agents: the complete Sanity documentation index is available at [https://www.sanity.io/docs/llms.txt](https://www.sanity.io/docs/llms.txt).

# Studio v3 to v4

Upgrading to v4 adds Node.js 20 as a requirement and requires minimal, if any, changes in your apps.

> [!TIP]
> Available now
> Sanity v4 is available now. See the details below and [follow this guide to upgrade your studio](https://www.sanity.io/docs/studio/upgrade).

Sanity Studio moved to v4 to align more closely with actively maintained versions of the Node.js runtime. We've updated the required Node.js version from v18 to v20+. You can [read more about why we're changing that major version](https://www.sanity.io/blog/a-major-version-bump-for-a-minor-reason).

While a major version change often indicates big changes, that's not the case here. In fact, the vast majority of studios and developers won't see a difference. 

## What this change means for you

In practice, not much. Your Studios are only built with Node.js, and will continue to operate as compiled, single-page web applications. If you've been deploying to Sanity with `sanity deploy`, your Studios are already built with an LTS version of Node.js and have been for quite a while.

Sanity Studio v4 and above requires Node.js v20.19 or later to run commands from the `sanity` CLI. This means if you're building and deploying a studio yourself, you'll need to update to a supported version of Node.js in order to run versions of `sanity` from 4.0.0 onward.

If you're running an earlier version of node during development, or you've set an older `engines` value in your `package.json` file, you may see an error or warning when attempting to upgrade without first updating Node.js.

You can check your installed version of Node.js with the `--version` flag.

**CLI**

```sh
node --version
```

For details on updating your installation of Node.js, [check their documentation](https://nodejs.org/en/download).

## Upgrade Sanity Studio

Upgrade with your package manager of choice by installing the latest v4 release.

**NPM**

```sh
npm install sanity@^4
```

**PNPM**

```sh
pnpm add sanity@^4
```

You can learn more about upgrading Studio and other packages in our [Upgrading Sanity Studio](https://www.sanity.io/docs/studio/upgrade) guide.