Search documentation
Search pages, components, blocks, styles and colours.
A set of checkable buttons—known as radio buttons—where no more than one of the buttons can be checked at a time.
Installation
Usage
import { Label } from "@/components/ui/label"
import { RadioGroup, RadioGroupItem } from "@/components/ui/radio-group"<RadioGroup defaultValue="option-one">
<div className="flex items-center gap-3">
<RadioGroupItem value="option-one" id="option-one" />
<Label htmlFor="option-one">Option One</Label>
</div>
<div className="flex items-center gap-3">
<RadioGroupItem value="option-two" id="option-two" />
<Label htmlFor="option-two">Option Two</Label>
</div>
</RadioGroup>Composition
Use the following composition to build a RadioGroup:
RadioGroup
├── RadioGroupItem
└── RadioGroupItemDescription
Radio group items with a description using the Field component.
Standard spacing for most use cases.
More space between elements.
Minimal spacing for dense layouts.
Choice Card
Use FieldLabel to wrap the entire Field for a clickable card-style selection.
For growing businesses.
For large teams and enterprises.
Fieldset
Use FieldSet and FieldLegend to group radio items with a label and description.
Disabled
Use the isDisabled prop on RadioGroup to disable all items.
Invalid
Use isInvalid on RadioGroupItem and data-invalid on Field to show validation errors.
API Reference
See the React Aria Radio Group documentation.