Change8

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.ts

Breaking Changes

Issue #1

ZodObject default behavior changed to $strip, which may affect how unknown keys are handled in object schemas.

Migration Steps

  1. 1
    Review 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