Content Releases and Router API improvements, and critical bugfixes in Sanity Studio

Published: March 25, 2025

v3.81.0

✨ Highlights

Content Releases improvements

  • Create documents directly in pinned releases: Skip extra steps by creating new documents directly within your pinned release perspective.
  • Auto-pinning for new releases: Newly created releases are now automatically pinned as your active perspective, providing a seamless workflow.

Router API improvements

Support for stickyParams in useRouter

navigate from useRouter now support a stickyParams option to allow for navigating and updating param state in the studio at once.

navigateStickyParams is deprecated from sanity/router. Instead, use navigate as follows:

const router = useRouter()

router.navigate({stickyParams: {paramKey: 'paramValue'}, replace: false})

Additionally, it's now possible to update route state and set stickyParams together:

const router = useRouter()

router.navigate({stateKey: 'stateValue'}, {stickyParams: {paramKey: 'paramValue'}})

Or, preferably, pass a single argument of options for navigate:

const router = useRouter()

router.navigate({
  stickyParams: {paramKey: 'paramValue'},
  state: {
    stateKey: 'stateValue'
  }
})

NOTE: state is optional. If omitted, then the stickyParams will be appended to the existing route; if state: null then there will be navigation back to the root path.

🐛 Notable bugfixes

Critical fixes

  • Studio Stability: Resolved a crash that occurred when using AI assist features.
  • Document Actions: Fixed incorrectly hidden duplicate action.

User experience improvements

  • Release Management: Added visual loading indicators when adding documents to releases.
  • Document Panel Logic:
    • Fixed improper unpublish functionality in draft view.
    • Fixed improper discard changes functionality in the published view
  • Status Indicators: Improved document status dots - green for published, orange for drafts, and combined overlay when both states exist.

Presentation tool fixes

  • Persistent Perspectives: Your perspective and excluded perspectives now follow you while navigating presentations.
  • Document Display: Fixed an issue where main documents weren't properly displayed when they only existed within a release.

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.

Loading...
Content Releases and Router API improvements, and critical bugfixes in Sanity Studio | Sanity Docs