Page Inspect

Intro | Zod

💎 Zod 4 is now stable!  Read the announcement.

Zod 4

The latest version of Zod

Search

⌘K

Zod 4

Release notes

Migration guide

Documentation

Intro

Basic usage

Defining schemas

Customizing errors

Formatting errors

Metadata and registries

New

JSON Schema

New

Codecs

New

Ecosystem

For library authors

Packages

Zod

Zod Mini

New

Zod Core

New

github logo

On this page

# 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";

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

Zod is also available as `@zod/zod` on jsr.io.

Zod provides an MCP server that can be used by agents to search Zod's docs. To add to your editor, follow these instructions. Zod also provides an llms.txt file.

## 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
}
}

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

- Resources
- API Libraries
- Form Integrations
- Zod to X
- X to Zod
- Mocking Libraries
- Powered by Zod

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

## Sponsors

Sponsorship at any level is appreciated and encouraged. If you built a paid product using Zod, consider one of the corporate tiers.

### Platinum

Cut code review time & bugs in half

coderabbit.ai


### Gold

The API platform for sending notifications

courier.com

Generate better SDKs for your APIs

liblab.com

Serverless Postgres — Ship faster

neon.tech

Build AI apps and workflows with Retool AI

retool.com

Generate best-in-class SDKs

stainlessapi.com

SDKs & Terraform providers for your API

speakeasy.com


### Silver

subtotal.com

juno.build

nitric.io

propelauth.com

cerbos.dev

scalar.com

trigger.dev

transloadit.com

infisical.com

whop.com

cryptojobslist.com

plain.com

inngest.com

storyblok.com

mux.link/zod


### Bronze

val.town

route4me.com

encore.dev

replay.io

numeric.io

marcatopartners.com

interval.com

seasoned.cc

bamboocreative.nz

github.com/jasonLaster

clipboardhealth.com/engineering



Migration guide

Complete changelog and migration guide for upgrading from Zod 3 to Zod 4

Basic usage

Basic usage guide covering schema definition, parsing data, error handling, and type inference

### On this page

Introduction

Features

Installation

Requirements

`"strict"`

Ecosystem

Sponsors

Platinum

Gold

Silver

Bronze