✨ Highlights

Product announcements

Studio users will now receive notifications about new Sanity features via a floating clickable card in the bottom-left corner of the interface. Clicking the card will open a modal with more details about the feature.

Previously seen product announcements can also be accessed anytime from the new “What’s New” item in the help menu.

Other features

• The global error UI has been refined so that it is clearer to users.
  • The global error UI now only displays the stack trace in development builds.
  • A Copy error details action has been added to the global error UI and the document list error UI. This allows users to easily share the error stack trace with developers.
  • Please note that these new strings cannot be internationalized, because the global error UI is rendered outside of the locale provider.
• The Reconnecting toast is no longer displayed if the connection is reestablished within two seconds.

🐛 Notable bugfixes

• Fixes issues occurring when a draft exist for a live-editable schema.
• Improves task assignee list performance.
• Improves Portable Text editor performance.

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

✨ Highlights

Performance improvements for large documents

This release introduces significant performance improvements for form state computation in Sanity Studio, especially for complex documents:

• Up to 10x performance improvement for documents with multiple large objects in arrays
• Noticeable improvements for documents with large Portable Text fields
• Memoization for form state computation

🐛 Notable bugfixes

• The _createdAt document property will now always be set to the time when the document in question was first created in its initial draft state rather than the time of publishing, as intended.
• In the Portable Text Editor, annotations can now be added across existing annotations and decorators without accidentally expanding or removing those.
• In the Portable Text Editor, a collapsed selection can now toggle off an entire annotation.
• A performance regression introduced in 3.52.3, affecting large Portable Text documents, has now been fixed.
• Toggling decorators in selections spanning empty lines in the Portable Text Editor now works more predictably.
• Lists created in the Portable Text Editor should now reset sublist indices under different parent list items (thank you, @phattran2905!).
• When focused, the Portable Text Editor now automatically adds empty markDefs arrays to blocks if missing.
• Array inputs now forward the received onItemPrepend and onItemAppend hooks to the insert button/array functions component.

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

✨ Highlights

Auto-updates enabled by default

Newly initialized studios now have auto-updates enabled by default.

This feature keeps your deployed studio up to date with the latest versions of Sanity while maintaining full control over your code and customizations, ensuring the same great developer experience you’re accustomed to.

With auto-updates enabled, you'll only need to rebuild and redeploy when making your own changes, as new features and improvements from Sanity are delivered automatically.

Learn more at https://www.sanity.io/docs/auto-updating-studios

📓 Full changelog

✨ Highlights

Improved developer tooling for Next.js and Sanity

• When sanity init is run inside a Next.js project, an appropriate CORS origin is added to the project
• When sanity init is run inside a Next.js project, environment variables are written to an .env.local file

🐛 Notable bugfixes

• Fixes flickering issue when navigating within presentation introduced in v3.57.0

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

🐛 Notable bugfixes

• Fixes a performance regression introduced in v3.51.0 (#7471)

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

✨ Highlights

Significant rendering perf. improvements (up to x10) in dev mode

This change enables styled-components "speedy mode" in sanity dev, improving developer mode performance. This change impacts only development builds (sanity dev) – production builds (sanity build or sanity start) remain unaffected since "speedy mode" has always been enabled in production.

Developers embedding Sanity Studio in other frameworks like Next.js or Remix need to adjust their own build tooling to declare the SC_DISABLE_SPEEDY flag to achieve the same performance benefits. For example, Next.js users can add this snippet to their next.config.{js,mjs,ts} file:

export default {
  env: {
    SC_DISABLE_SPEEDY: 'false' // makes styled-components as fast in dev mode as it is in production mode
  }
}

For Safari users, while they will still be able to inspect and see CSS rules coming from styled-components, these will now be read-only in the DevTools inspector. The performance benefits from enabling "speedy mode" in development mode are significant for Safari users and outweigh the convenience of being able to edit these rules directly in the inspector. With Hot Module Reload, developers can still quickly make changes to their source code, and the new styles will apply immediately.

Enabling "speedy mode" offers a faster development experience across the board. Developers using Safari for testing purposes can still verify the functionality of the studio, and for more detailed CSS editing, they can switch to Chrome, Firefox, or other Chromium-based browsers like Arc or Brave.

It's still possible to restore the old behaviour of disabling speedy in dev mode in userland with a custom sanity.cli.ts override:

import {defineCliConfig} from 'sanity/cli'
import {type UserConfig} from 'vite'

export default defineCliConfig({
  vite(viteConfig: UserConfig): UserConfig {
    return {
      ...viteConfig,
      define: {
        ...viteConfig.define,
        // `sanity dev` enables speedy in both development and production, this line restores the default `styled-components` behaviour of only enabling it in production
        'process.env.SC_DISABLE_SPEEDY': JSON.stringify(process.env.NODE_ENV !== 'production'),
      },
    }
  },
})

add --max-fetch-concurrency to prevent stalled validators

This update addresses an issue where the sanity documents validate CLI command could time out when validating documents with complex custom validation rules. The changes include:

1. Increased default maximum fetch concurrency from 10 to 25, which should resolve most timeout issues.
2. Added a new CLI flag --max-fetch-concurrency to allow users to adjust the maximum number of concurrent client.fetch requests during validation.
3. Made the default maximum custom validation concurrency explicit and configurable.

Usage:

sanity documents validate --max-fetch-concurrency <number>

These changes should improve the performance and reliability of document validation for projects with complex custom validation rules. Users experiencing timeouts during validation should try increasing the --max-fetch-concurrency value if issues persist with the new default.

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

✨ Highlights

Improved document sync notification

Fixes an issue where the syncing document notification would sometimes remain on the screen indefinitely, even after the document was no longer visible. The toast is now dismissible, improving the user experience when working with synchronized documents.

Copy document URL to clipboard

A new feature has been added to the document pane, allowing users to easily copy the current document's URL to their clipboard. This makes sharing documents with colleagues and collaborators more convenient.

Ending the "Array Tree Editing" beta

Thank you to everyone who participated in the "Array Tree Editing" beta. Based on your feedback, we are ending this experiment as we continue to explore better ways to navigate nested structured.

🐛 Notable bugfixes

• Optimized rendering in Presence: We’ve optimized how presence changes are handled, reducing unnecessary re-renders in the Studio. This enhancement improves overall performance when multiple users are working on the same document.
• Respect for --no-auto-updates flag in CLI: Fixed an issue where the CLI would not respect the --no-auto-updates flag, ensuring that this configuration setting now behaves as expected.
• Improved feedback when extracting schema: The schema extraction process now outputs the file path, providing clearer feedback and making it easier to locate the saved schema.
• Constrain size for date picker popover: Added a prop to constrain the size of the date picker popover in the DateTimeInput UI component, providing more control over its appearance, especially in modal contexts.

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

✨ Highlights

Request access to Studios

Users can now request access to a project they're not yet a member of, straight from the Studio's "Not authorized" screen. Project administrators will be alerted by email and can approve or deny the request from the project settings area.

TypeGen updates

Running sanity typegen will now by default generate a query typemap which the Sanity Client can use to automatically infer the returned types of a query.

🐛 Notable bugfixes

• The TypeGen CLI command should now correctly detect and generate types defined by defineQuery from the next-sanity package.
• Fixes an issue with FormInput causing includeField to not have any effect for nested paths.
• Fixes an issue with the cursor sometimes moving around as you typed in the Portable Text Editor.
• Fixes an issue where references would not open if clicked inside a Field Group.
• Fixes an issue where it wasn't possible to copy a text selection inside a text field.

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

✨ Highlights

Copy Paste Improvements

• Adds support for copying supported object types into array fields
• Adds support for copying and pasting individual array items

Multiple deployment targets for Sanity Studio

Introduces support for adding multiple [my-company].sanity.studio deployments for a project. Link your studio code to a specific hostname with the new studioHost property in the CLI config as shown below, or select or create a deployment target when prompted while running sanity deploy. You can now see all your studio deployments in the project management settings.

// ./sanity.cli.ts

import {defineCliConfig} from 'sanity/cli'

export default defineCliConfig({
  api: {
    projectId: 'projectid',
    dataset: 'production'
  },
  // Tip: You can use an environment variable for studioHost if you want 
  // to deploy separate studios for production, staging, testing etc.
  studioHost: 'my-company'
})

Read more in the Hosting and deployment article in the docs.

🐛 Notable bugfixes

• Fixes an issue where you were able to copy and paste documents that contained non-existing references
• Fixes an issue where getValueAtPath() utility wouldn't work for 0 index path segments (['array', 0])

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

Improved Sanity Client and TypeGen integration

With the new defineQuery utility it is no longer necessary to pass generics into client.fetch calls for the sanity typegen command to generate type definitions for query results. 🥳
Update @sanity/client to v6.21.0 or later, then add "overloadClientMethods": true to your sanity-typegen.json configuration file, and finally wrap your query strings in the new defineQuery utility method from groq:

import {createClient} from '@sanity/client'
-import groq from 'groq'
+import {defineQuery} from 'groq'
-import type { SettingsQueryResult } from "~/sanity.types";

const client = createClient({ /* ... */ })

-const settingsQuery = groq`
+const settingsQuery = defineQuery(`
  *[_type == "settings"][0]
-`
+`)

-const settings = await client.fetch<SettingsQueryResult>(settingsQuery)
+const settings = await client.fetch(settingsQuery)

Huge thanks to @romeovs for championing this feature!

🐛 Notable bugfixes

• Fixes default messaging in the environment variable file created by sanity init --env
• Fixes an issue that could cause wrong list counts in the Portable Text Editor
• Fixes an issue that could cause malformed strings to appear in documents passed to migration scripts
• Fixes several issues that could cause "missing context" errors in certain environments
• Fixes an issue causing the Presence avatar overlays on form fields not to appear when Sanity Studio is embedded in a React 19 app

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

🐛 Notable bugfixes

• Fixes a bug that prevents keyboard shortcuts from pasting images and files.

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

🐛 Notable Bugfixes

• Restores the FieldPresenceWithOverlay export to address issues with third-party plugins relying on this feature. Plugin authors are advised to use the FieldPresence export instead, as the two have always been identical.
• Resolves a build configuration issue that caused interoperability problems with CommonJS (CJS) modules, leading to errors during Vite's startup process.
• Fixes a bug that prevented keyboard shortcuts from pasting files and images correctly. This ensures that the copy/paste handler does not interfere with file and image inputs.
• Adds 'image' literal to ImageMetadataType. Thanks @xuzuodong!

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

🐛 Notable bugfixes

• General improvements to studio performance
• Switching between workspaces now uses an anchor link, resolving an issue where document operations might occur across datasets.

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

🐛 Notable bugfixes

• Fixes a regression that caused the Media plugin (sanity-plugin-media) to crash due to a configuration issue with the build tooling in the CLI.

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

🐛 Notable bugfixes

• Fixes a package bundle configuration issue in auto-updating Studios that caused Presentation to crash.
• Adds aliases to internal Vite configuration used when running sanity build and sanity deploy to prevent missing React context issues.
• Improves error messages when duplicate instances of Sanity are found in node_modules.

📓 Full changelog

✨ Highlights

Clickable links in comments

URLs included in comments are now rendered as clickable links, which is infinitely more useful than unclickable links.

Other features

• Updates to configuration and blog template files when initializing a project inside a Next.js app: using an src folder in your directory if it exists, some changes to schemas and how they're imported.

🐛 Notable bugfixes

• Fixes a regression causing platform-aware hotkeys (for example, Ctrl + Option + D for duplicating a document) not to be displayed in tooltips.

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

✨ Highlights

New: Copy-and-paste fields and documents

This version of Sanity Studio introduces a powerful new way to work with structured content within Sanity Studio: Copy-paste support for fields and documents. You can now use the familiar copy-and-paste hotkeys (cmd/ctrl+c and cmd/ctrl+v) and the field and document actions menus to copy content across different fields and document types seamlessly.

• Copy between different document types: You can seamlessly copy fields from one document and paste them into a different document type while maintaining the content structure.
• Copy deeply bested structures: Easily copy entire blocks of Portable Text and arrays with complex nested structures between documents.
• Copy full documents: Effortlessly copy full documents and integrate them into existing documents of the same or similar types.

https://github.com/sanity-io/sanity/assets/10551026/43698966-4ab0-45fe-b6fd-b45b5de9072e

Beta: Array Tree Editing

Sanity offers powerful content models that let you define lists of object types and even nest these, if necessary. This enables developers to work with intuitive and convenient data structures in the API, but it has sometimes led to a cumbersome editorial experience with a lot of navigation between layers of modals.

That's why we're thrilled to introduce an improved experience for editing arrays of objects. With the array tree editing, you can browse and edit array items in one place, making working with nested content much simpler and faster.

To enable the new array tree editor, add the following to your Sanity Studio configuration:

// sanity.config.ts
export default defineConfig({
  // ...
  beta: {
    treeArrayEditing: {
      enabled: true,
    },
  },
});

Note: While in beta, the array tree editor has limited support for references. References to other documents do not appear in the array tree editor and will open in a new modal. Additionally, Portable Text fields are not fully supported.

Beta: Auto-updating Sanity Studio deployments

We're shipping improvents and fixes to Sanity Studio on a weekly basis. To make it easier to get these improvements to Sanity Studio users without requiring developer involvement, we have shipped a way to build the studio for auto-updates.

You can try this out with the new --auto-updates flag to the sanity build and sanity deploy CLI commands. This enables your Sanity Studio to automatically update to the latest minor and patch versions (3.x.x) of Sanity Studio without having to rebuild and redeploy new bundles.

Learn more about the new auto-update flag in docs.

Improved support for large datasets exports

To improve the export experience for users with large datasets, we have introduced a new cursor export mode in the Sanity CLI:

sanity dataset export --mode cursor

In this mode, the CLI will use cursors under the hood when exporting, which can significantly speed up the export process for larger datasets.

Note: Unlike the traditional export mode, the cursor mode does not create a snapshot of the dataset. Instead, it pulls data as it exports, which may result in inconsistencies if documents in the dataset is modified during the export process.

🐛 Notable bugfixes

• Fixes an issue when trying to extract schemas/deploy GraphQL APIs when a sub-dependency tries to call document.execCommand at import time.
• Fixes a warning being printed about using useClient() without specifying an API version.
• Fixes an issue where having styled-components listed in devDependencies instead of dependencies would cause the CLI to try to install it as a dependency in a loop.

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

✨ Highlights

New TypeGen Features

Better GROQ Function Coverage

We have added the following improvements to type generation for GROQ query results:

• Added support for array functions
• Added support for dateTime::now() and global::now().
• Added support for round(), upper(), and lower() functions.
• Support negative groups in conditions: *[!(_type == "post")]

Improved Union Handling in TypeGen

TypeGen now correctly expands all unions inside an object, addressing this reported issue on GitHub. Previously, only a part of a union might be returned. TypeGen now ensures that all object types in a union are expanded and included in the generated types.

// Example query
export const HomePageQuery = groq`*[_type == "page" && slug.current == "homepage"]{
  title,
  components[] {
    _type == "hero" => { title, "image": image.asset->url },
    _type == "cta" => { title, link }
  }
}`;

TyeGen will now generate the following type for the query above:

export type HomePageQueryResult = Array<{
  title: string;
  components: Array<
    | { _type: 'hero'; title: string; image: string }
    | { _type: 'cta'; title: string; link: string }
  >;
}>;

New import path for the Portable Text Editor

We’ve started work on a standalone Portable Text Editor package, and thus transitioned to using the @portabletext/editor package instead of the now deprecated @sanity/portable-text-editor package. This change includes several internal improvements and fixes. You can follow this work in this repository on GitHub — more documentation to come.

Advanced users who have used the @sanity/portable-text-editor dependecy should update to @portabletext/editor to ensure continued support and improvements.

🐛 Notable bugfixes

• Fixes an issue where FormInput would not render fields inside a fieldset.
• Various TypeGen bug fixes.

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

🐛 Notable Bugfixes

• Fixes a regression that caused the Select button to not appear for single-asset sources.
• Fixes a bug to allow the --no-dry-run and --no-confirm CLI options to be used together. Big thanks to @pawelngei!

📓 Full changelog

Install or upgrade Sanity Studio

To initiate a new Sanity Studio project or upgrade an existing one, please refer to our comprehensive guide on Installing and Upgrading Sanity Studio.

If you are updating from a version earlier than 3.37.0, you should also check out this article to ensure your dependencies are up to date.

🐛 Notable Bugfixes

• Fixes an issue that caused trailing commas to appear when sanitizing schemas.
• Adds periodic debug logging and improves error handling in the dataset export workflow.

📓 Full changelog