Zod

TypeScript-first schema validation with static type inference
by @colinhacks

Website • Discord • 𝕏 • Bluesky

Zod 4 is now stable! Read the release notes here.

Featured sponsor: Jazz

Interested in featuring? Get in touch.

Introduction

Zod is a TypeScript-first validation library. Using Zod, you can define schemas you can use to validate data, from a simple string to a complex nested object.

import * as z from "zod/v4";
 
const User = z.object({
  name: z.string(),
});
 
// some untrusted data...
const input = { /* stuff */ };
 
// the parsed result is validated and type safe!
const data = User.parse(input);
 
// so you can use it with confidence :)
console.log(data.name);

Features

Zero external dependencies
Works in Node.js and all modern browsers
Tiny: 2kb core bundle (gzipped)
Immutable API: methods return a new instance
Concise interface
Works with TypeScript and plain JS
Built-in JSON Schema conversion
Extensive ecosystem

Installation

npm install zod       # npm
deno add npm:zod      # deno
yarn add zod          # yarn
bun add zod           # bun
pnpm add zod          # pnpm

Zod also publishes a canary version on every commit. To install the canary:

npm install zod@canary       # npm
deno add npm:zod@canary      # deno
yarn add zod@canary          # yarn
bun add zod@canary           # bun
pnpm add zod@canary          # pnpm

Requirements

Zod is tested against TypeScript v5.5 and later. Older versions may work but are not officially supported.

`"strict"`

You must enable strict mode in your tsconfig.json. This is a best practice for all TypeScript projects.

// tsconfig.json
{
  // ...
  "compilerOptions": {
    // ...
    "strict": true
  }
}

`"moduleResolution"`

Your "moduleResolution" should be set to one of the following. The legacy "node" and "classic" modes are not supported, as they do not support subpath imports.

"node16" (default if "module" is set to "node16"/"node18")
"nodenext" (default if "module" is set to "nodenext")
"bundler"

Ecosystem

Zod has a thriving ecosystem of libraries, tools, and integrations. Refer to the Ecosystem page for a complete list of libraries that support Zod or are built on top of it.

I also contribute to the following projects, which I'd like to highlight:

tRPC - End-to-end typesafe APIs, with support for Zod schemas
React Hook Form - Hook-based form validation with a Zod resolver
zshy - Originally created as Zod's internal build tool. Bundler-free, batteries-included build tool for TypeScript libraries. Powered by tsc.