●Change8

Migrating to Zod v4.0.6

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

Released: 7/23/2025

1
Breaking Changes
2
Migration Steps
5
Affected Symbols

⚠️ Check Your Code

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

z.catchz.literallocales.islocales.bglocales.da

Breaking Changes

●Issue #1

Unwidened the catch input type, which may affect how error types are inferred in .catch() blocks.

Migration Steps

  1. 1
    If upgrading from Zod 3 to Zod 4, use the zod-v3-to-v4 codemod as referenced in the migration guide.
  2. 2
    Review .catch() usage if relying on specific input type widening.

Release Summary

Zod v4.0.6 introduces new Icelandic, Bulgarian, and Danish translations, fixes literal escaping bugs, and refines the catch input type. It also updates documentation for RFC 9562 and provides resources for Zod 3 to Zod 4 migration.

Need More Details?

View the full release notes and all changes for Zod v4.0.6.

View Full Changelog