●Change8

Migrating to Sanity v5.0.1

Version v5.0.1 introduces 2 breaking changes. This guide details how to update your code.

Released: 12/17/2025

2
Breaking Changes
2
Migration Steps
12
Affected Symbols

⚠️ Check Your Code

If you use any of these symbols, you need to read this guide:

@portabletext/editorgroq-js@portabletext/plugin-one-line@sanity/media-library-typesuse-effect-event@sanity/preview-url-secret@sanity/debug-preview-url-secret-plugin@sanity/insert-menu@sanity/visual-editing-csm@sanity/visual-editinglodash@sanity/import

Breaking Changes

●Issue #1

The plugin `@sanity/preview-url-secret/sanity-plugin-debug-secrets` has been replaced by `@sanity/debug-preview-url-secret-plugin`. Update imports accordingly.

●Issue #2

The internal implementation of effect handling has been refactored, replacing `use-effect-event` with standard React hooks. This might affect custom hooks relying on the previous implementation details.

Migration Steps

  1. 1
    To upgrade to this version, run: `npm install sanity@latest`.
  2. 2
    If you were using `@sanity/preview-url-secret/sanity-plugin-debug-secrets`, replace it with `@sanity/debug-preview-url-secret-plugin`.

Release Summary

Sanity Studio v5.0.1 is a maintenance release focused on dependency updates, internal refactoring (replacing use-effect-event), and fixing schema conflicts and file accept support.

Need More Details?

View the full release notes and all changes for Sanity v5.0.1.

View Full Changelog