Unlock seamless workflows and faster delivery with our latest releases- get the details

Upgrade studio packages

From time to time, versions of packages Sanity Studio depends on needs to be upgraded. This can be done either by manually entering a new version of the dependency in your studio folder's package.json, or by running a command from your command line.

Currently, the Studio requires the following packages and versions:

  • react@^18.2.x
  • react-dom@^18.2.x
  • styled-components@^6.x

Sanity UI

Additionally, if your Studio includes customizations using @sanity/ui, the version of @sanity/ui required by the current version of the Sanity Studio is v2.1.0 or later. (We recommend always upgrading to the latest version.)

Upgrading from styled-components v5 to v6

To upgrade from styled-components v5 to v6, you can either edit package.json directly and run npm|pnpm|yarn install after. In addition to upgrading styled-components, you might also remove the react-is dependency that used to be a required peer dependency of styled-components v5, unless your studio code directly depends on it.

npm

npm install "styled-components@^6"

npm rm @types/styled-components react-is

pnpm

pnpm install "styled-components@^6"

pnpm rm @types/styled-components react-is

yarn

yarn add "styled-components@^6"

yarn rm @types/styled-components react-is

Note: if you have local customizations in your Sanity Studio that's using styled-components you may need to do some adjustments to your Studio code as well. Please consult the styled-components migration guide for more details.

Upgrading React

npm

npm install "react@^18.3" "react-dom@^18.3"

pnpm

pnpm install "react@^18.3" "react-dom@^18.3"

yarn

yarn add "react@^18.3" "react-dom@^18.3"

Note: if you have local customizations in your Sanity Studio and are upgrading between major versions of React (e.g. going from version 17 to 18) you may need to do some adjustments to your React components as well. Please consult the React changelog for details on how to migrate to the latest version.

Was this article helpful?