Sourced from zod's releases.

v4.0.0-beta

Zod 4 is now in beta.

• Release notes
• Migration guide

The repo now contains three separate packages:

• zod
• @zod/mini: a tree-shakable variant of Zod.
• @zod/core: a library that implements logic/parsers shared between zod and @zod/mini.

During the beta period:

• zod — published continuously to zod@next , e.g. zod@4.0.0-beta.20250410T214751
• @zod/mini — published continuously to @zod/mini@next , e.g. @zod/mini@4.0.0-beta.20250410T214751
• @zod/core — published to latest in the v.0x version range (initial development in semver)

To install/upgrade:

npm upgrade zod@next
npm install @zod/mini@next
npm install @zod/core

A note on versioning

For simplicity, additional beta will be continuously released as additional commits are made to the v4 branch.

After the beta:

• stable versions of zod and @zod/mini will be released as 4.0.0. They will remain version-locked moving forward. They will be pinned to a specific @zod/core version.
• @zod/core will be released as 1.0.0. It will not be version-locked to zod and @zod/mini. This gives those libraries the freedom to evolve their APIs independent of @zod/core. Moreover, @zod/core will likely serve as the underpinning for additional libraries in the future, so it may implement/modify code that isn't used by either zod or @zod/mini.

• See full diff in compare view

You can trigger Dependabot actions by commenting on this PR:

• @dependabot rebase will rebase this PR
• @dependabot recreate will recreate this PR, overwriting any edits that have been made to it
• @dependabot merge will merge this PR after your CI passes on it
• @dependabot squash and merge will squash and merge this PR after your CI passes on it
• @dependabot cancel merge will cancel a previously requested merge and block automerging
• @dependabot reopen will reopen this PR if it is closed
• @dependabot close will close this PR and stop Dependabot recreating it. You can achieve the same result by closing it manually
• @dependabot show <dependency name> ignore conditions will show all of the ignore conditions of the specified dependency
• @dependabot ignore this major version will close this PR and stop Dependabot creating any more for this major version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this minor version will close this PR and stop Dependabot creating any more for this minor version (unless you reopen the PR or upgrade to it yourself)
• @dependabot ignore this dependency will close this PR and stop Dependabot creating any more for this dependency (unless you reopen the PR or upgrade to it yourself)