●Change8

Migrating to Zod v3.25.49

Version v3.25.49 introduces 1 breaking change. This guide details how to update your code.

Released: 6/2/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:

z.customz.literalz.enum

Breaking Changes

●Issue #1

Validation issues in z.custom are now fatal. This means if a z.custom check fails, subsequent refinements or checks in the chain will not execute for that value.

Migration Steps

  1. 1
    Review usage of z.custom; ensure that logic does not rely on non-fatal error behavior for subsequent validations.

Release Summary

This release updates z.custom to treat validation issues as fatal and includes several documentation fixes and minor feature enhancements for regex and enums.

Need More Details?

View the full release notes and all changes for Zod v3.25.49.

View Full Changelog