Radio Group

Basic

A set of round buttons where you can select only one option from the group.

Installation

npx shadcn@latest add @intentui/radio

Composed components

Manual installation

npm i react-aria-components

Anatomy

import { Description, Label } from "@/components/ui/field"
import { Radio, RadioGroup } from "@/components/ui/radio"

<RadioGroup name="billing">
  <Label>Billing Cycle</Label>
  <Description>
    Select how often you'd like to be billed
  </Description>

  <Radio value="monthly">
    <Label>Monthly</Label>
    <Description>Billed every month</Description>
  </Radio>
  <Radio value="quarterly">
    <Label>Quarterly</Label>
    <Description>Billed every 3 months</Description>
  </Radio>
  <Radio value="yearly">
    <Label>Yearly</Label>
    <Description>
      Billed once per year with a discount
    </Description>
  </Radio>
</RadioGroup>

Orientation

By default, the radio group is vertically oriented. You can change it to a horizontal orientation by using the orientation prop.

Without label

The label is optional. You can omit it if not needed.

Description

Add a description to the radio group by passing the description prop.

Validation

Try submit the form without selecting any radio option to see the validation error.

Controlled

You can control the radio group value using the value prop.

Uncontrolled

You can control the radio group value using the defaultValue prop.

Disabled

When the radio group is disabled, it cannot be interacted with.