# Shadcn Write-In Answer

> A written answer beside the choices

- Type: example, free and open source (MIT)
- Component: [Questionnaire](https://web.dev.reui.io/components/questionnaire.md)
- Page: https://web.dev.reui.io/components/questionnaire/c-questionnaire-3
- Docs (Base UI): https://ui.shadcn.com/docs/components/base/questionnaire.md
- Docs (Radix UI): https://ui.shadcn.com/docs/components/radix/questionnaire.md
- MCP: `get_example("c-questionnaire-3")`
- Registry item: https://web.dev.reui.io/r/styles/base-nova/c-questionnaire-3.json
- Uses: Button, Card, Label, Questionnaire

## Best for

A write-in row with its own visible Label that clears the picked radio as you type and submits under the question name

## Agent notes

- Pass your own `id` to `QuestionnaireInput` so the `Label` `htmlFor` finds it; a passed id wins over the generated one
- The typed answer posts under the same `name` as the radios, so `answerLabel` treats a value matching no option as the write-in

## When not to use

- A write-in on a question the visitor may also decline: use [Optional Skip](https://web.dev.reui.io/components/questionnaire/c-questionnaire-5.md) (`get_example("c-questionnaire-5")`)
- A step asking for a long free text reply, a date or a file: use [Field](https://web.dev.reui.io/components/field.md) (`get_component("field")`)

## Install

```bash
npx shadcn@latest add @reui/c-questionnaire-3
```

## About Shadcn Questionnaire

### When to use

- Onboarding and setup flows that ask one single or multiple answer question per screen
- Short intake surveys, such as how a visitor heard about you or what they are moving off
- Question flows with an optional step, a branch that joins on an earlier answer or a rule across answers

### When not to use

- Steps that each hold a whole screen of mixed fields rather than one question: use [Stepper](https://web.dev.reui.io/components/stepper.md) (`get_component("stepper")`)
- A bar that reports how far an upload, a goal or a task has got, with no questions: use [Progress](https://web.dev.reui.io/components/progress.md) (`get_component("progress")`)
- A complete first-run screen that also collects a profile, a timezone and teammate invites: use the [Onboarding blocks](https://web.dev.reui.io/blocks/application/onboarding.md)

### Agent notes

- A `QuestionnaireItem` whose `name` is missing from the root `items` list is left out of the flow and the count, with only a dev warning
- `handleSubmit` reads the answers with `FormData` and only renders a local confirmation; send them to your API from there
- `QuestionnaireActions` is a 3 column grid placed for Previous, Skip and Next or Submit, so keep any other button outside it

Every ReUI item has a twin like this one; the index is https://web.dev.reui.io/llms.txt. Agents with the ReUI MCP (https://web.dev.reui.io/docs/mcp) get the same guidance from the getters named above.