Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes a bug that accidentally permitted referencing drafts

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Improved Sanity UI based array inputs

We have refactored the default inputs used for array types in the Sanity Studio to Sanity UI. As an added bonus, the array inputs now supports keyboard reordering by pressing space followed by arrow keys when the drag handle has focus.

🐛 Notable bugfixes

• Fixes issue where the validation list got hidden behind the fullscreen 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

• Fixes continous incoming mutations preventing lists from loading items on slow connections
• Fixes user fallback avatar displaying incorrect initials on special characters
• Fixes query URL not updating in vision if query resulted in an error
• Fixes vision not showing location of error in query
• Fixes mismatch between displayed and stored date in date/datetime inputs in certain timezones

📓 Full changelog

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes incorrect API version option in vision

📓 Full changelog

Upgrade Sanity Studio with:

sanity upgrade

Other features

• Added support for custom API versions in vision tool

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes a regression that made the search bar unusable

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

API versioning support in client and studio

On Thursday, March 25th, we will start versioning our APIs to provide you with great new functionality. The details on the new features will be announced at the Content is Data event on March 25th, and in a subsequent blog post.

Your code should continue to work as before, but we now recommend you specify which API version you want to use when instantiating a new Sanity client:

Using @sanity/client

import SanityClient from '@sanity/client'

const client = new SanityClient({
  apiVersion: '2021-03-20',
  projectId: '...',
  dataset: '...',
  useCdn: true,
})

The documentation has more information on the API versioning scheme used in Sanity.

Using the "global" studio client

If you are currently importing from part:@sanity/base/client in your Sanity studio, plugins or similar, you should now specify which API version to use:

// Before:
import client from 'part:@sanity/base/client'

client.fetch('*[...]')


// After:
import sanityClient from 'part:@sanity/base/client'

const client = sanityClient.withConfig({
  apiVersion: '2021-03-20'
})

client.fetch('*[...]')

This enables plugins to work without having to agree on a common API version, as every plugin defines the API version it is known to work with.

Using sanity-php

use Sanity\Client as SanityClient;

$client = new SanityClient([
  'apiVersion' => '2021-03-20',
  'projectId' => '...',
  'dataset' => '...',
  'useCdn' => true,
]);

Other clients and libraries

Over the coming days and weeks, we'll be adding API versioning to all our official tooling and libaries, and hope to see community plugins and clients embrace and use the new API versioning functionality!

Other features

• The altText was added to the image and file asset types - deploying a new version of your GraphQL API will now let you specify the field when fetching data

🐛 Notable bugfixes

• Fixes an issue where the slug input would not work inside of arrays, and would not broadcast the presence status of someone editing the field

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes an issue that would in some cases make the date picker lose focus when using arrow keys to move between months
• Fixes a regression introduced in v2.6.3 that caused values coming from date inputs to be stored with the same format as datetime fields
• Fixes an issue with studio search not returning results when search string includes special characters

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Revamped Date and DateTime inputs

This release includes a ground-up rewrite of the default Date and DateTime inputs in the Sanity Studio. The new date inputs are powered by Sanity UI and comes with improved keyboard accessibility and less bugs.

Before

After

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

• The language filter plugin now supports specifying one or more default languages (Thanks to @spacedawwwg!)

🐛 Notable bugfixes

This release:

• Fixes occational z-index issues on narrow screens
• Fixes an issue that could sometimes cause an error when opening the review changes panel
• Hides the "generate" button in slug inputs without a configured source
• Fixes a z-index issue with the Google Maps input making the search field disappear behind the map

📓 Full changelog

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes a few React warnings originating in the image/file inputs

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

• Adds support for Sanity UI based Toasts in the Studio
• Migrates default image and file inputs to Sanity UI

Other features

• Adds ability to delete incomplete uploads in the UI

🐛 Notable bugfixes

• Fixes issue with message saying "Files not supported 'unknown.txt'" sometimes appearing on drag'n'drop in studio
• Fixes various focus and paste related visual issues in image and file inputs

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

• Adds --mock-browser-env flag to sanity exec command, for cases where imported files reference browser-like APIs (window, requestAnimationFrame etc)
• .env files will now be loaded before running any Sanity CLI command

🐛 Notable bugfixes

• Fixes a bug where storybook would crash on startup.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes an issue that made the document actions render behind the document editor in some cases.
• Fixes minor CSS issues of Studio hints.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed a small regression introduced in v2.4.1 that sometimes could cause scrolling to the bottom on page load.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixed various issues causing unexpected scroll jumps in the editor
• Prevented unnecessary unmount/remount of array items after open/close for editing

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

• Added support for asynchronous filter option for reference inputs. Thanks @andyrichardson!

🐛 Notable bugfixes

• Fixed a regression introduced in v2.3.8 that didn't pass the document to custom asset source components.
• Fixed an issue that caused clicks on labels within fieldsets to focus the wrong field.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Improved performance when editing documents

This release features various performance optimizations that prevent unecessary rerendering of React components, making the UI respond faster.

Vertical centering of navbar items

Thanks to a PR from @khellang, the navbar will now center navbar items vertically, which can be an issue when a custom Studio logo takes up more space than is intended.

🐛 Notable bugfixes

• Fixes an issue that caused the NumberInput to display an empty string instead of 0.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

This release fixes a performance issue introduced in v2.2 that would make typing in text fields slow in certain cases.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

This release updates the dependency on @sanity/ui.

📓 Full changelog