●Change8

Migrating to Sanity v4.0.0

Version v4.0.0 introduces 1 breaking change. This guide details how to update your code.

Released: 7/15/2025

1
Breaking Changes
3
Migration Steps
7
Affected Symbols

⚠️ Check Your Code

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

@sanity/presentation-comlink@sanity/comlink@sanity/import@sanity/preview-url-secret@portabletext/editor@sanity/uisanity.video

Breaking Changes

●Issue #1

Removed support for Node.js version 18; the base requirement is now Node.js 20. Update your Node.js environment to version 20 or higher to use this release.

Migration Steps

  1. 1
    Run `npm install sanity@latest` to upgrade.
  2. 2
    Ensure your development environment uses Node.js version 20 or higher, as Node 18 support has been removed.
  3. 3
    Refer to the comprehensive guide on [Installing and Upgrading Sanity Studio](https://www.sanity.io/docs/upgrade) for detailed upgrade instructions.

Release Summary

Sanity Studio v4.0.0 introduces new CLI commands for documentation and drops support for Node.js 18, requiring Node.js 20 as the new base environment. This release also includes numerous dependency updates and fixes related to video schema handling.

Need More Details?

View the full release notes and all changes for Sanity v4.0.0.

View Full Changelog