Introduction ... Using Zod, you can define schemas you can use to validate data, from a simple string to a complex nested object.

For complete documentation on Zod's schema API, refer to Defining schemas. Defining a schema ... Zod Zod Mini

Complete API reference for all Zod schema types, methods, and validation features

In Zod 3, when the results were unmergable, Zod threw a ZodError with a special "invalid_intersection_types" issue. In Zod 4, this will throw a regular Error instead.

In other cases, you may have a set of Zod schemas you'd like to represent using multiple interlinked JSON Schemas, perhaps to write to .json files and serve from a web server.

Zod Mini implements the exact same functionality as zod, but using a functional, tree-shakable API. If you're coming from zod, this means you generally will use functions in place of methods.

TypeScript-first schema validation with static type inference

import * as z from "zod"; const schema = z.strictObject({ username: z.string(), favoriteNumbers: z.array(z.number()), });

Metadata z.globalRegistry For convenience, Zod provides a global registry (z.globalRegistry) that can be used to store metadata for JSON Schema generation or other purposes.

Jul 8, 2025 · If I naively published zod@4.0.0 to npm, the vast majority of the libraries in Zod's ecosystem would need to publish a new major version to properly support Zod 4, include some high …