# FORMS_FIELD_NOT_DRAWABLE

<!-- Generated by docs/modules/diagnostics from the package catalogs. Write a guide in docs/diagnostics/<CODE>.md instead of editing this file. -->

`formFields()`, `toElicitation()`, `toChatModal()`, or `AutoForm` throws `FORMS_FIELD_NOT_DRAWABLE`. One field of the form schema has a shape that the surface cannot draw. The message names the field, its shape, and the surface.

## Why it happens

Every surface draws a flat form: one input for each text, number, true or false, or choice. These shapes have no input:

- a nested object
- a list
- a union of types
- a root that is not an object

An MCP elicitation also refuses a choice of numbers, because MCP choices are text.

`FORMS_FIELD_NOT_DRAWABLE` is a configuration error. It throws when you draw the form, and it does not come back as `[error, value]`.

## Fix it

Keep the form flat. Move nested data to its own form, or join it into one text field.

```diff [server/forms/contact.ts]
 export default defineForm({
   schema: v.object({
     email: v.pipe(v.string(), v.email()),
-    address: v.object({ street: v.string(), city: v.string() }),
+    street: v.string(),
+    city: v.string(),
   }),
 })
```

For an MCP elicitation, write a choice of numbers as text, such as `v.picklist(['1', '2', '3'])`, and convert the answer on the server.

## Related

- [One schema on every surface](https://vitehub.dev/docs/forms/server-api)
- [Forms limits and errors](https://vitehub.dev/docs/forms/limits-and-errors)

## Source

`FORMS_FIELD_NOT_DRAWABLE` belongs to the `forms` package. Its catalog entry is in [`src/errors.ts`](https://github.com/vite-hub/vitehub/blob/main/packages/forms/src/errors.ts#L23). It is raised in [`src/fields.ts`](https://github.com/vite-hub/vitehub/blob/main/packages/forms/src/fields.ts#L191).

See [all Forms diagnostics](https://vitehub.dev/docs/forms/diagnostics).

<!-- vitehub-docs:section-links -->
## In this section

- [Overview](https://vitehub.dev/raw/docs/forms.md)
- [Get started](https://vitehub.dev/raw/docs/forms/get-started.md)
- [Server API](https://vitehub.dev/raw/docs/forms/server-api.md)
- [Limits and errors](https://vitehub.dev/raw/docs/forms/limits-and-errors.md)
- [Vue](https://vitehub.dev/raw/docs/forms/vue.md)

Next: [Diagnostics](https://vitehub.dev/raw/docs/forms/diagnostics.md)

All pages: [llms.txt](https://vitehub.dev/llms.txt)
