Zod v3 Documentation
Zod is a TypeScript-first schema declaration and validation library designed to be developer-friendly. With Zod, you declare a validator once and Zod automatically infers the static TypeScript type. It eliminates duplicative type declarations and makes it easy to compose simpler types into complex data structures.
Quick Reference
| File |
Title |
Description |
contents/README.md |
Main Documentation |
Comprehensive API reference covering primitives, objects, arrays, unions, refinements, transformers, and all Zod features |
contents/ERROR_HANDLING.md |
Error Handling Guide |
Explains ZodError and ZodIssue types, error formatting, and customization with error maps |
contents/MIGRATION.md |
Migration Guide |
Steps for upgrading from Zod 1→2 and Zod 2→3, including breaking changes and new features |
contents/README_KO.md |
Korean Documentation |
Korean translation of the main README |
contents/README_ZH.md |
Chinese Documentation |
Chinese translation of the main README |
contents/blog/clerk-fellowship.md |
Zod 4 Development |
Blog post about Zod 4 development plans and funding |
When to use
Use this skill when the user asks about:
- Zod schema validation and type inference
- Creating and composing Zod schemas (strings, objects, arrays, unions, etc.)
- Validation methods (.parse, .safeParse, .refine, .transform)
- Error handling with ZodError
- Migrating from Zod 1 or Zod 2 to Zod 3
- TypeScript integration with Zod
- Custom validation logic and refinements
How to find information
- Check Quick Reference above for relevant file
- Read
TOC.md for complete listing
- Read specific files from
contents/{filename}
For API reference and usage examples, start with contents/README.md.
For error handling details, see contents/ERROR_HANDLING.md.
For version migration, see contents/MIGRATION.md.
