Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

Highlights

Review Changes

Review Changes is the latest in a series of improvements we have made to the authoring experience in the Sanity Studio. You now get full document revision history right inside the Sanity Studio. Down to click and keystroke, you can see who contributed what to any version of a document and roll back a single field. You can also make your own custom diff components with the new APIs and React components.

Read the full blog post

Server-side dataset copying

This release also marks the first feature for advanced dataset management: server-side dataset copying. If your project is on the enterprise plan, you can now run sanity dataset copy production staging to copy the contents including assets of a dataset to another.

GraphQL Document field

When deploying new GraphQL APIs for your datasets, you will now get a Document field which allows you to query for a document with a given ID without having to know it's type up front. You will still need to use fragments with type checks to access fields based on the type, of course:

{
  Document(id: "some-doc-id") {
    # `_id` is defined on the `Document` interface,
    # so it does not require a type assertion
    _id

    # Unique fields on the `post` type
    ...on Post {
      title
      category
    }
  }
}

UI improvements

We are continously improving the UI, accessibility, and the editoral experience of the Studio. This release includes:

• Improvements to the hotspot and crop tool, and the way images are previewed.
• The builtin form fields have been made more consistent.
• The document’s status bar has a brand new design.
• Improved popovers and dialogs with better contrasts/shadows.
• Modals in the Desk tool are restricted to their pane, to improve the experience for split views.
• All the core UI components have been ported to TypeScript.

Breaking changes

react-icons no longer used by Sanity studio

You're free to use react-icons as you see fit, of course - but you'll have to make sure you declare it as a dependency in your studios package.json file.

Previously, the Sanity studio internals were using react-icons version 2. If your studio does not list react-icons as a dependency, that means your studio is implicitly also depending on that version. When upgrading, you may encounter build failures because it can no longer find the module. To fix these errors, you have two options:

1. Install react-icons@^2.0.0 as a dependency.
2. Install react-icons@^3.0.0 as a dependency, and run a code modification script to change the import paths for icons. After upgrading @sanity/cli to the latest version (npm i -g @sanity/cli), you can run sanity codemod reactIconsv3 in your studio folder to automatically change these import paths.

Notable bugfixes

• Fixed a bug where running sanity start would require you to be authenticated

Thanks!

The Sanity team would like to thank @alexcaballerosa and @benjaminsehl for volunteering their time to help us test Review Changes. Both were diligent, enthusiastic and generous. We learned a lot.

📓 Full changelog