Facing an issue

[chalapathi-ct]

import {z} from 'zod';

const testing = z.object({
    testing: z.string().describe("testing")
})
z.toJSONSchema(translatedQuestionPaper);

The description field is coming fine in my dummy setup with zod v4.

But in my project The description fields were stripped out, not sure why using the save zod v4.

[inkeep-ai-assistant[bot]]

The .describe() method can be used on a Zod schema, such as z.string(), to add a description. However, if you want to add metadata to a schema property within an object, you need to call .describe() directly on the property schema, not on the object schema itself(1). This is valid:

const testing = z.object({
  testing: z.string().describe("testing")
});

If you are trying to convert this schema to JSON Schema with z.toJSONSchema(), Zod 4 supports this and will include the description in the output(1).

If you are experiencing an issue, make sure you are using Zod 4 and that you are calling .describe() on the property schema, not on the object itself. If you try to call .describe() on the object schema after its creation (e.g., obj.describe("...")), this will create a new schema with the description at the object level, not at the property level, and the property descriptions will not be set unless they were defined at the property schema level(2).

📚 Sources:

1. Zod v4 LLMs-Full
2. .describe does not work on existing object

---

Have another question? Just tag @inkeep.