Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed a regression introduced in v0.144.0 that broke editing of a document that had an _id that included a dot character (.)
• Fixed a bug that affected portable text fields: When switching between documents from the search bar (and with no document list panes open), the portable text editor would retain the value from the previous document.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Remove a part for the snackbar that doesn't exist or isn't used.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

This release contains fixes to improve UI, developer experience, documentation, and for Studio customization.

🐛 Notable bugfixes

• Fixed an annoying portable text editor bug where the editor scrolled to top after re-acquiring focus.
• Fixed a bug where the Create New Document Button in some circumstances would be missing when using Structure Builder.
• Fixed a bug where DropDownButton not being closable when using button.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Introducing: Initial Value Templates

export default {
  name: 'post',
  type: 'document',
  title: 'Blog post',
  initialValue: () => ({
    publishedAt: new Date().toISOString()
  }),
  fields: [
    // ... all the fields
  ]
}

With the newest version of Sanity Studio, you can now set initial values for all your document types. It’s a great way to save your editors time and effort spent on repetitive tasks.

• Prefill fields with minimal configuration.
• Fetch content from APIs for new documents.
• Add multiple templates for quick document creation.

Read the blog post!

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade Sanity Studio by running this command in your project folder:

sanity upgrade

✨ Highlights

This reverts a change introduced in the previous release which could potentially make some custom branded studio's logos take up too much space.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade Sanity Studio by running this command in your project folder:

sanity upgrade

✨ Highlights

This release contains a bunch of small fixes to improve UI, developer experience, documentation, and for Studio customization.

Thanks to @boyum and @fishintaiwan for their community contributions!

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed a paste bug regression in the editor for portable text 🐞
• Fixed two bugs with HTML to portable text deserializaion (keep space between two links and an error that was thrown in some circumstances) 🐛

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Output better error message in the CLI when session is invalid and you have to log in again.
• Fixed a bug where nested portable text editors would error if pasting into it, or inserting a custom object, when being empty.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Flow => TypeScript

Although this should not be noticable for end users yet, we have now converted all the packages that were using Flow to use TypeScript instead. Check out our blog post for more details.

GraphQL schema fixes

Two long-standing bugs in the GraphQL schema generating code has now been fixed: circular references in types should no longer give stack overflow errors, and subtyped scalars should now work as expected. Huge thanks to Richard Sewell for taking the time to look at these!

Other features

• Added the getDocuments() method to @sanity/client for fetching multiple documents in one go. Note: this method should be used sparingly and performing a GROQ query is usually a better option.

🐛 Notable bugfixes

• Inform users about sanity.io/create when running sanity init
• Fixed a bug where slugs would always be required after writing it once and then deleted it
• Fixed history pane background color for better Studio customization experience
• Fixed a bug where adding geopoints to arrays through @sanity/google-maps-input would break
• Fixed a bug where drag-and-drop of files to an array would crash
• Fixed a bug where changing the crop area of an image would crash when not first setting a hotspot
• Fixed a bug where any configured accept parameter would not be passed down to the underlying input. Also changed the default accepted file types for images to image/*, which should provide a more user-friendly way to select images

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed various issues with the Portable Text editor (#1486, #1480, #1481, #1479, #1489)
• Improved image browsing experience with a checkered background to indicate image transparency (#1488)
• Made videos in dashboard open in new tabs (#1476)

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

Deprecating support for React < 16.8

Today the minimum version of React required by the Content Studio is 16.3. This means the developer team at Sanity must be careful about using new features introduced in React after v16.3.

The most notable thing we're missing is the ability to use React Hooks. So today we're deprecating versions prior to React 16.8, and soon we will start ship new versions of the sanity studio that relies on features introduced after 16.3 up to and including 16.8.

If you are using an old version of React in your studio, you will now see a deprecation warning telling you to upgrade the versions of react and react-dom. You can read more about upgrading the packages required by the Sanity studio here

Note: This should not cause any trouble as there's no breaking changes between React 16.3 and 16.8, but if you run into any problems, please drop by our community slack and let us know.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Bugfixes and improvements

• Fixed a bug in the editor for Portable Text where span text containing an annotation would not be patched correctly (#1465).
• Fixed a bug in the editor for Portable Text where custom block objects containing the key .children under some circumstances would not be patched correctly (#1468).
• Previously, if a custom input didn't have a (React) ref, the studio would crash and display an error message. Since it's a lot more common now to create function components in React and function components can't be given refs, we made sure to display a warning pointing at the problem and the actual input instead of failing. More details can be found in our help article (#1467).
• Fixed a bug in history view, where signed out SSO users would cause the studio to crash (#1469).
• When there is only one available tool (for example the desk-tool by default) we no longer show the tool switcher (#1458).
• If you add your studio URL to the list of allowed CORS origins but forget to check for Allow credentials, you will now get a more helpful warning (#1431).
• Improved the way available updates to the Studio are displayed (#1472)

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Increased timeouts for snackbars (#1457)
• Fixed an issue where sanity init would crash when choosing to import sample data for a new project (#1459)
• Fixed an issue causing a studio error when a sanity studio was in a subfolder in a create-react-app project – big thanks to @scottandrews98 for helping us investigate the issue! (#1462, #1463)
• Fixed an issue that caused an error when editing portable text inside an array or when the first field of a document was a block array (#1464)
• Fixed link color in selected history view item (#1429)
• Made the root container use the base font-family for easier Studio customization (#1460)

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Safari login improvements

We've had several people report issues with logging in to the Sanity studio using Safari. This release contains a fix that should resolve this issue.

CLI: Multi-document delete

You can now delete multiple documents at once with sanity documents delete. Just pass a list of document IDs to delete:

sanity documents delete doc1 doc2 doc3

🐛 Notable bugfixes

• Fixed a bug where restoring an old version would lose the content of array fields

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

New notification snackbars! 🍫

This release introduces new stackable notification “snackbars” that stacks, are closable, can have actions in them, and can be used by plugin authors with lots of configuration options (custom icons, etc.).

React Hooks support 🎣

The content studio now works with custom components and plugins that's using React hooks.

Note: In order to use React hooks with your Sanity Studio, make sure to upgrade react and react-dom in your studio to version 16.8 (or later). Read more about how to upgrade React in your studio here.

🐛 Notable bugfixes and optimizations

• Slugs inside of arrays can't be automatically checked for uniqueness. Previously, they triggered a number of requests when the document changed content, without actually performing a valid check. Users are now required to provide their own isUnique check should they want to ensure uniqueness.
• Fixed a bug that would cause an error when restoring old versions of a document that has references to now deleted documents. If you restore a version that has a reference to a nonexisting document, that reference field will now be removed upon restore.
• Missing avatar does not break mobile view.
• Optimized studio list views which now should load significantly faster.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

in the studio folder.

✨ Highlights

Invite collaborators from the command line

You can now use the Sanity CLI tool to invite people to your project. From your studio folder, run sanity users invite and you'll be prompted for the email and role of the user. You can also use flags (--role) if you want to automate it.

In addition, you can list the members of a project by running sanity users list. You'll get the user IDs, names and roles of all users in the project.

In a future release, we'll be sure to add more commands, such as removing a user from the project, or modifying their role.

🐛 Notable bugfixes

• Fixed a bug where unloading previews in the editor for Portable Text led to side effects and jumping.
• Fixed a bug in the editor for Portable Text where focus was not restored when toggling fullscreen mode.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed a bug where one could not restore to a previous published version when document history was truncated
• Fixed a bug which would occasionally cause the Studio build to fail

✨ Enhancements

• UX improvements to the newly released history

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

This release fixes a regression introduced in the previous release that accidentally removed the ability to to delete a draft

📓 Full changelog

Upgrade the Command Line Interface (CLI) with

npm install --global @sanity/cli

Upgrade the Content Studio with:

sanity upgrade

✨ Highlights

Introducing History Experience

We are very pleased to announce that we just released the document history experience for the Sanity Studio, as well as a new API for querying document revisions.

You can now browse document revisions, as well as the ability to restore earlier versions. Document history also shows who contributed to what edits – a semi-huge improvement to collaborative workflows.

Standard plans have 3 days of history while advanced plans come with 90.

Check out our blog post to learn more.

📓 Full changelog

Upgrade the Content Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fix export failing on certain files due to a missing MD5 header
• Fix reference input showing "Type to search" on empy fields in read-only mode

📓 Full changelog