Migrating to Zod v3.25.66
Version v3.25.66 introduces 1 breaking change. This guide details how to update your code.
Released: 6/16/2025
1
Breaking Changes
1
Migration Steps
3
Affected Symbols
⚠️ Check Your Code
If you use any of these symbols, you need to read this guide:
ZodObjectinst.shapeapi.tsBreaking Changes
●Issue #1
ZodObject default behavior changed to $strip, which may affect how unknown keys are handled in object schemas.
Migration Steps
- 1Review ZodObject schemas to ensure the new default $strip behavior aligns with expected data validation logic.
Release Summary
This release updates the default behavior of ZodObject to $strip and includes documentation improvements and minor bug fixes for the website.
Need More Details?
View the full release notes and all changes for Zod v3.25.66.
View Full Changelog