Skip to main content
The Radio component allows users to select exactly one option from a set of mutually exclusive choices.

Basic usage

Props

Radio

string
required
The value of the radio button.
boolean
Whether the radio button is disabled.
string
Additional CSS classes to apply to the radio button.

Radio.Group

string
The controlled value of the selected radio button.
string
The default selected value for uncontrolled usage.
(value: string) => void
Callback fired when the selected value changes.
string
The name attribute for all radio buttons in the group.
boolean
Whether all radio buttons in the group are disabled.
boolean
Whether the radio group is required.
string
Additional CSS classes to apply to the group container.

Controlled radio group

Uncontrolled radio group

With descriptions

Disabled state

Disabled group

With form integration

Required radio group

Accessibility

  • Built on Base UI Radio primitive with full accessibility support.
  • Proper ARIA attributes are automatically applied.
  • Supports keyboard navigation with arrow keys to move between options and Space to select.
  • Radio buttons within a group are properly associated.
  • Works seamlessly within forms with proper name attribute.
  • Label association ensures the entire label is clickable.
  • Required state is properly communicated to screen readers.