Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

TypeScript definitions for @sanity/client

@sanity/client now has TypeScript support, including TSdoc for methods.

🐛 Notable bugfixes

• Fixed a bug where an extra undo step was made when deleting everything inside the Portable Text editor.
• You can now paste text from Notion.so into the Portable Text editor.
• @sanity/block-tools htmlToBlocks will now normalize the produced content. Objects are given keys and adjecent spans with similar marks will be merged.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

Rolling back some regressions for the publish and restore actions introduced in 1.148.0. Sorry for the inconvenience!

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

Rolling back some regressions for the publish and restore actions introduced in 1.148.0. Sorry for the inconvenience!

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Moving from 0.x to 1.x

In this release we have bumped the official @sanity-packages on npm from v0.147 to v1.148.

Normally, a major version bump indicates breaking/non backwards compatible changes, but in this case everything that used to work with the previous release should also work with this release.

Read more about this "major non-event" and our position on breaking changes in our blog post.

TypeScript support for Sanity Studio

Sanity Studio and the Sanity CLI now supports TypeScript. Go to the documentation to learn how to get started.

Studio performance and stability improvements

We have also done a couple of stability fixes and performance fixes that should improve the overall editing experience.

Groundwork for upcoming features

We have also done a lot of restructuring of the internal Studio codebase to enable some long awaited features. Stay tuned!

📓 Full changelog

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed import bug where missing asset documents would not be identified as actually missing

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Improved performance of import/export

The command line tools for importing and exporting datasets have had several improvements to performance and stability, especially when working with a large number of assets.

🐛 Notable bugfixes

• Fixed an issue where many people editing the same document would occasionally fail
• Fixed an issue where conflicting document IDs would be retried when importing
• Fixed an issue where the progress indication for importing assets would show them as complete too early

📓 Full changelog

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed desk tool lists not refreshing on when sort order changes

📓 Full changelog

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

🔗 Fine-grained reference fields

Reference fields can now be given an additional GROQ-filter to help constrain the search, making it easier to find the documents you are looking for.

Note that this only helps the search, it does not guarantee that the referenced document will match the filter in the future.

Read the documentation for the reference type to find out how to use this new functionality.

⚡ Faster loading of long lists

The desk tool should now load the initial set of documents in a list faster than previously. When scrolling, it will load additional documents. We're working on further improving the performance of lists.

🐛 Notable bugfixes

• Fixed bug where documents with numeric IDs would not be sorted correctly in desk tool
• Fixed bug where unsetting an image or file field would not unset the _type property
• Fixed bug where the experimental spaces feature would link to incorrect space in certain cases

📓 Full changelog

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed the desk tool potentially crashing on unpublished document when using a deprecated part

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

• Fix an import issue introduced in previous release

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Hints mode

The Sanity Studio now comes with an optional sidebar that is used for onboarding new developers. It can be opened and closed, and removed by configuring sanity.json. It will not appear in existing studios unless you enable it youself. It will be added as a default to the starters on sanity.io/create.

🐛 Notable bugfixes

• Normalize blocks received from custom paste handler 📋
• @abrougher helped us spell correctly 🙇

📓 Full changelog

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed incorrect options being passed to document component view
• Fixed plugin configuration files not being initialized when running sanity graphql deploy
• Fixed asset download connection errors not being retried on export

📓 Full changelog

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed bug where slug fields with no source property would crash the desk tool

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Environment variable support

A much requested feature - the Sanity Studio now allows configuration of key parameters such as the project ID and dataset through environment variables, both in development and for deployment. This should make it much easier to integrate it into continuous deployment workflows.

In addition, we now inject environment variables with the SANITY_STUDIO_ prefix into the build process, allowing you to use them when customizing the Sanity Studio.

Read more about this feature in our documentation.

Template for custom asset source plugins

With the recently launched support for pluggable asset sources, we've had a lot of fun seeing what people build with it. In this release of the CLI, we've included a plugin template for building an asset source. You can now do sanity init plugin in your studio folder and choose the "Custom asset source plugin" option to get the boilerplate code up and running.

🐛 Notable bugfixes

• Fixed the experimental Action UI affordances not being respected
• Fixed image and file fields not validating their fields property

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed issues with react-icons if you had installed a newer version locally that uses the new import syntax in that module. Fixed a problem introduced in v0.146.1
• Reintroduced passing document prop to asset-source-plugin, that was reverted by v0.146.2 because of circular import issues in v0.146.1 which are now fixed.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

• Reverts a regression in the previous release. We are sorry.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

• An enhancement to the asset source plugin support, where plugins also recieve the document by props.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Introducing: Pluggable asset sources for Sanity Studio!

Read the blog post.

This release includes support for adding additional asset sources for the Sanity Studio. You can install them as plugins, or make you own. You can also customize if you want to override the default asset source selection globally, or for specific image fields.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fix regression in v0.145.0: the title attribute was removed from the editor/document node.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Improved editor user interface

The primary actions for a document (publish, unpublish, discard changes, delete) have been moved to a footer at the bottom of the screen, along with the current status of the document. This makes it easier to see the current status without scrolling to the top of the screen as well as logically groups document actions.

This change to the UI paves the way for upcoming features that we think will more than justify getting used to the new behaviour.

We've also centered the form within it's pane, giving you more whitespace and, we think, a more comfortable editing experience.

More helpful development server status

When the development server is rebuilding the latest changes, a message will now appear in the studio informing you that it's currently processing the change.

If the changes cannot be applied without reloading, you will get a message prompting you to reload the studio to see the latest changes.

Fixed GQL top-level reference/array types

A long-standing bug has prevented named reference and array types defined in the types array of your schema to be used in GraphQL schemas. This is now finally fixed - hooray! 🎉

React 16.9 minimum requirement

In a prior release several months ago, we deprecated React versions below 16.9. With this release we've made it the minimum required version to run the studio. This means that Sanity plugins targeting 0.145.0 or higher can now use the React hooks feature.

📓 Full changelog