Skip to main content

Zod import targets

Control how generated schemas import Zod via the zodImportTarget config option.

Install Zod in your app (peer dependency), then pick one of:

  • auto (default): import * as z from 'zod' (namespace import for better tree-shaking)
  • v3: import { z } from 'zod' (named import for compatibility)
  • v4: import * as z from 'zod/v4'

Notes

  • In single‑file bundles, a single Zod import is hoisted at the top.
  • This setting affects all generated files and variants.

Quick recipes

  • Copy one of these into your config JSON:
zod-generator.config.json
{ "zodImportTarget": "auto" }
zod-generator.config.json
{ "zodImportTarget": "v4" }

See also

  • Reference → Bytes and JSON
  • Configuration → Modes and Variants