Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

React 17 support

• React 17 is now supported as a peer dependency.

🐛 Notable bugfixes

• Fixed issues in the editor for Portable Text related to marks when splitting lines at start/end offsets.
• Fixed a bug where clicking on a collapsed field inside a modal would close it.
• Some smaller visual improvements

Other features

• Added Github actions for enforcing consistent code style with Prettier and Eslint

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed an issue where array items still couldn't be deleted in Safari and Firefox

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

This release:

• Fixes an issue where presence didn't display avatars inside collapsed objects and fieldsets.
• Fixes a bug where marks continued in the next paragraph when pressing enter (splitting) at the end of a Portable Text block and gave a validation error.
• Fixes a bug with undo/redo when using marks in the Portable Text Editor.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed a bug where some users were unable to delete array items with Firefox

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed issues related to modals and layering
• Fixed a bug where array items without a _key property would crash the desk tool
• Fixed an issue where changes to portable text inside a modal would not be saved if you closed the modal too quickly after making changes
• Fixed a fieldset issue where certain input types would break column layouts
• Fixed a bug where type icons did not show for references in preview component in arrays and portable text editor

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Reverted a change that accidentally disabled the pencil icon that marks an input value as changed

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed layering issues with dialogs, menus and dropdowns causing them to fall "behind" others
• Fixed text in tabs overflowing in certain cases
• Fixed react-hooks not using the latest version of @sanity/base
• Fixed typescript issues causing parts not to be resolved to any
• Fixed document pane not using it's assigned title
• Fixed form scrolling to the center of focused element instead of its top

📓 Full changelog

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed diff tooltip annotation position when near top/bottom of panel
• Fixed image diff component crashing on legacy image asset IDs
• Fixed studio crashing when importing presence components from old path
• Fixed modal stacking when inside of other modals
• Fixed reference search appearing "behind" other dialogs
• Fixed crash when passing draft ID to document pane

📓 Full changelog

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

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed a crash when invalid data types were encountered for an object field
• Fixed a bug causing array items without an _type property not to show up in the UI

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed an issue where a named custom block type would wrongly be included in the insert menu for the editor of Portable Text.
• Fixed an issue with the editor of Portable Text refusing to paste HTML when you are using a named custom block type.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed an issue where uploading images under some circumstances would give an error.
• Fixed an issue with the Vision plugin when using the Studio with a SSO implementation.
• Fixed text contrast issues.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

It's now possible to strip formatting from multiple blocks of the editor for portable text, by selecting content and clicking off the active formatting buttons in the toolbar.

🐛 Notable bugfixes

• Fixed a bug where clicking items in the root validation list would not focus on the validated item properly.
• Optimized the editor to not re-render block object previews unless they are actually changed. This will increase performance on load heavy previews like video and code blocks.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed an issue that could sometimes make the Studio fail with an error message saying Could not resolve jsonType of undefined.
• Fixed a dependency issue that could sometimes make sanity build to fail in production environments.
• Fixed an issue where the hotspot/crop would sometimes bounce back to a previous position after editing it
• Fixed color contrast issues with custom theme colors for buttons and navbar

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

This fixes a few stability issues and bugs introduced in the previous release.

🐛 Notable bugfixes

• Fixed an issue where some part paths were wrong, causing sanity check to fail
• Fixed an issue where the tags input field would overflow and hide tags when many tags. This also caused tags to get the wrong height.
• Fixed an issue that would in some occations cause the Studio to fail with an error saying cannot read property styles of undefined
• Fixed an issue where editing objects inside Portable Text in some situations would not open the editing interface.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Social Presence

Presence allows you to see other user currently in the Studio and which field they are editing. Read our blog post about it.

Presence API

You can add presence to your custom input components by integrating the new components that ships with this upgrade. Learn more in the documentation.

Improvements to the editorial experience

This upgrade includes a range of improvements to the general editorial experience and UI. Including new color scheme, better visual hiearchy, improved validation messages, new icon set, significant performance enhancements to the Portable Text editor, and much more!

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Support overriding validation on array subtypes 🐞

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed a bug where mp3/mp4 files would not be recognized as valid assets when exporting
• Fixed a bug where sanity build would crash if no static folder existed

📓 Full changelog

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed bug where certain object types with an asset reference field not referencing a Sanity asset would fail to be exported
• Fixed bug where export would print MaxListenersExceededWarning messages to the console

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🔧 Improvements

• Added the endpoint URL in the output when running sanity graphql list
• Your dates custom formatting will now appear in validation messages
• Adjusted the color scheme of the default Studio theme to match Sanity’s color palette

🐛 Notable bugfixes

• Dampened some too persistent error messages when losing connection between the Studio and the server
• Fixed an issue that could sometimes make a document action button disappear.
• Fixed a bug where the NotFound page in the Studio would sometimes throw an error.

📓 Full changelog