Validation Errors

Different validation error shapes, nested schemas, and custom error handling.

Formatted Errors (default)

Default validation error shape with nested _errors arrays.

Result:

Flattened Errors

Using flattenValidationErrors to get formErrors + fieldErrors shape.

Result:

Nested Schema

Complex nested Zod schema with superRefine producing random validation errors at different levels.

Result:

returnValidationErrors

Manually returning validation errors from server action code (use the formatted errors example above, try username 'johndoe').

The formatted and flattened examples above both use returnValidationErrorsto manually set field-level errors from the server. Try username "johndoe" to see a user_suspended error, or any other value to see incorrect_credentials.

throwValidationErrors

Client created with throwValidationErrors: true, validation errors throw instead of returning.

Result:

Custom Error Shape

Using handleValidationErrorsShape to transform validation errors into a custom format.

Result: