Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes some permission issues where users weren't able to edit documents when they should be
• Fixes a bug where placeholder text in an empty Portable Text Editor would be stuck for a split second when it should not be
• Fixes a bug where splitting lines in the Portable Text Editor including an inline object would corrupt the inline object data
• Fixes an issue in Vision where controls and result were cut off in smaller viewports
• Fixes an issue in Vision where the params frame could not be selected
• Fixes an issue in Vision where tabbing to the params frame and editing the JSON would crash the studio

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Maintainance update to the Portable Text Editor

This update brings fixes for several bugs and improvements to the Portable Text Editor's performance and reliability. It also includes:

• Better keyboard accessibility when editing embedded objects
• Better tracking of validation errors within the editor
• Better Android and IME support

Default .eslintrc file when creating new projects with the CLI

New projects bootstrapped with the CLI will now contain a default .eslintrc that extends our new shared ESLint config @sanity/eslint-config-studio.

🐛 Notable bugfixes

• Fixed an issue where the mode parameter for the code input would be incorrectly interpreted (Thanks Tommy for the PR!)
• Fixed an issue where sanity upgrade would fail if @sanity/code-input was installed.
• Fixed an issue where sanity upgrade, sanity versions and sanity debug would fail if running without any dependencies installed.
• Removed third party dependency causing security warnings with npm audit (immer.js)

📓 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 with @sanity/code-input causing graphql deploy to error with the message TypeError: Cannot read property 'setModuleUrl' of undefined

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

New features

• Allow loading more syntaxes for the @sanity/code-input programmatically, see the code input README for more details
• You can now specify coupon codes when creating a new project using the CLI, by using the --coupon flag, eg sanity init --coupon <code>

🐛 Notable bugfixes

• Fixes bug where initial values would no longer work when inserting in arrays
• Fixes a bug that caused some false warnings with duplicate and update permissions

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Field groups

Added Field Groups to schemas and document view. Read more about the feature here https://www.sanity.io/docs/field-groups.

New array item menus

Arrays now supports adding new items before/after existing array items, and also duplicating existing items

New and improved document status indicator

Updated document status indicator with saving state and animation.

Other features

• Added SANITY_STUDIO_PROJECT_NAME environment config variable

🐛 Notable bugfixes

• Fixed an issue that could in some cases cause matching documents to be excluded from the search results
• Made the default title of referenced document types more user friendly
• Fixes an issue that could occasionally cause a query error during publish of a new document created directly from the reference input
• Fixes an issue that caused singleton documents to never load if no schemaType was provided.
• Fixes UI issue in Portable Text toolbar

📓 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 could occasionally cause a query error during publish of a new document created directly from the reference input

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Changes to sanity upgrade

sanity upgrade now behaves slightly different:

1. It now respects the version ranges and pinned versions declared in your package.json
2. Tries not to upgrade non-studio modules such as @sanity/block-content-to-html
3. Shows a more prominent message if there are major updates available with a link to the changelog

🐛 Notable bugfixes

• Fixes an issue that caused a crash instead of a warning screen when omitting schemaType from S.documentList() (#3022)
• Fixes an issue that caused singleton documents to never load if no schemaType was provided (#3043)

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes a bug that caused focus loss on an array item after closing the edit dialog
• Fixes a bug that caused popovers from closing when clicking outside of the current pane content
• Fixes an issue that could cause a max request size exceeded error for documents that had many references.
• Fixes a bug that could sometimes cause document preview for object fields with name "title" to crash on reload
• Added more details in docs for the client.delete() API

📓 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 where previews of a reference to a document with a field named 'title' did not display correctly
• Fixes a visual error where popover dialogs were appearing beneath other panes (#2970)
• Fixes an issue where 'create' intents set in custom structures would not appear in pane headers (#3007)
• Fixes sanity dataset import when targeting an ndjson file with relative file URLs (#2998)
• Fixes a bug preventing sanity logout from working in the case of expired sessions (#3001)
• Fixes a bug where the CLI would not be able to log a user in if an existing invalid/expired session was present (#3002)

Other features

• Added support for HTTP proxies when using dataset import/export commands (#2999)
• Validation menu button now reflects the highest level of validation (#3005)

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

References in place

Users can now create a reference to a draft within the context of the referring document. This allows for a smoother workflow where having to leave the document you are working on in order to create and publish the document you wish to refer to is no longer necessary,
This new behavior of the reference input can be disabled by setting the property disableNew: true.

More:

• Reference schema type documentation
• Connected Content – Introduction to references in Sanity

Conditional readOnly fields and fieldsets

The ability to define if a field is editable based on conditions defined in a schema.

Info-level validation

In addition to being able to provide validation errors, developers can also provide guidance with ℹ️ -symbols to give in-line help to editors.

New modal options in Portable Text editor

The Portable Text editor now supports a new modal option with a type and width property. This means you can customize the size of annotation popovers (a much requested feature).

  type: 'block',
  marks: {
    annotations: [
      {
        type: 'object',
        name: 'link',
        title: 'Link',
        options: {
          // 👇👇👇
          modal: {
            type: 'popover',
            width: 'medium' // the default is "small"
          },
          // 👆👆👆
        },
      },
    ],
  },
  // ...

🐛 Notable bugfixes

• Fixes a case where the sanity graphql deploy command would not exit after a successful deploy.
• Fixes a bug where importing the @sanity/eventsource module in non-browser, non-node.js environments could potentially crash because of a window reference.

📓 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 where desk structures with observables would be stuck loading.
• Fixes an issue where the new-document dialog would not use the selected template

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes a bug that disabled all options in the global 'create document'-menu due to insufficient permissions

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Introduces a larger initial min-width for the DocumentPane.
• Huge GROQ queries will now use the API-CDN when useCdn: true. Previously these would go to the regular API endpoint.
• Fixes typo in deferred-visibility for mutations
• Added schema option to configure spell-checking for Portable Text via options.spellCheck on the block type.

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

• Fixes a bug in Safari where editing annotations (like links) in the portable text editor would make the popover dialog jump around.

📓 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 where some custom styles implementations for the Portable Text Editor caused an error

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

✨ Highlights

Portable Text Editor Input migrated to Sanity UI

We have now migrated the Portable Text (PT) editor in the Sanity Studio to use Sanity UI. This marks the completion of the migration of the entire Studio to @sanity/ui.

In addition to the migration:

• Generally improved stability and performance of the PT editor.
• Added a new affordance for editing/removing text annotations. This will make it easier to e.g. edit link details.
• Fixed a bug where undo/redo history was not maintained in memory when collapsing/expanding the editor.

Other features

• Allows plan selection with sanity init --project-plan <plan>
• Improves usability of ValidationError by making cloneWithMessage optional

📓 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 causing sanity exec to crash

📓 Full changelog

Upgrade the Command Line Interface (CLI) with:

npm install --global @sanity/cli

Upgrade Sanity Studio with:

sanity upgrade

🐛 Notable bugfixes

This release includes a new implementation of our pane and intent resolver that resolves intents deeper in your structure and provides more consistency with getDefaultDocumentNode.

• Fixes an issue where creating a new document would open in the fallback editor instead of as a child to the current pane.
• Fixes an issue where opening a search item from the top search would result in the fallback editor instead of user-defined structure.
• Fixes inconsistencies with getDefaultDocumentNode where configured views would not appear in the fallback editor.
• Fixes an issue with GraphQL deploy causing "Error: Cannot find module '@sanity/core/_internal'

Other features

• Support for GROQ query params in patch and delete methods in the client (#1826). Thanks @KarlGe!

📓 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 introduced in #2884 that caused the saving spinner to not appear while a change was still syncing

📓 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 causing GraphQL deploys to fail after installing to babel ^7.16.0 see (#2899).

📓 Full changelog