August 2026 - Questionnaire
A new component for building multi-step question flows with fixed, freeform, multiple, and skippable answers.
Today, we're releasing Questionnaire, a new component for multi-step question flows. Use it for agent clarification prompts, onboarding, surveys, intake forms, and configuration.
Questionnaire is available for Base UI, React Aria, and Radix across all eight styles.
Question 1 of 3
What should the agent build next?
Choose a direction or describe another task.
Tool call timelineShow what the agent ran and what came back.AApproval checkpointsAsk before sensitive or destructive actions.BSub-agent handoffsMake delegated work and results easier to follow.C
Choose an answer to continue.
What should every progress update include?
Select all that apply, or skip this question.
ProgressADecisionsBRisksCNext stepD
Choose an answer or skip this question.
When should work begin?
Choose when the agent should begin the work.
Start nowANext development cycleBAdd it to the backlogC
Choose an answer to continue.
PreviousSkipNextSave plan
<span class="line" data-line=""><span style="color:#032F62;--shiki-dark:#9ECBFF">"use client"</span></span>
<span class="line" data-line=""><span style="color:#D73A49;--shiki-dark:#F97583">import</span><span style="color:#005CC5;--shiki-dark:#79B8FF"> *</span><span style="color:#D73A49;--shiki-dark:#F97583"> as</span><span style="color:#24292E;--shiki-dark:#E1E4E8"> React </span><span style="color:#D73A49;--shiki-dark:#F97583">from</span><span style="color:#032F62;--shiki-dark:#9ECBFF"> "react"</span></span>
Features#
- Single and multiple selection with native radios and checkboxes.
- Freeform answers alongside fixed choices.
- Explicit skipping for optional questions.
- Previous, next, submit, and custom progress controls.
- Required and custom validation.
- Controlled navigation, saved defaults, and conditional questions.
- Keyboard navigation with optional letter or number shortcuts.
- Native form serialization and server-rendered collection state.
- Standalone, Card, and Dialog composition.
Installation#
pnpm dlx shadcn@latest add questionnaire
@shadcn/react#
The <Questionnaire /> component is also available as an unstyled headless primitive in @shadcn/react. Read the docs to learn more.
[
View Questionnaire
Fetched August 5, 2026


