Skip to content

Radio Group

A set of checkable buttons where only one can be checked at a time.

Install

Bash
npx @madeui/cli add radio-group

Usage

TSX
import { RadioGroup, RadioGroupItem } from '@/components/ui/radio-group';

Composition

TSX
<RadioGroup>
  <RadioGroupItem />
  <RadioGroupItem />
</RadioGroup>

Description

Pair each item with Field, FieldContent, and FieldDescription to add helper text.

Up to 5 projects and community support.

Unlimited projects and priority support.

Choice card

Wrap each Field in FieldLabel for a clickable, card-style selection.

Disabled

Set disabled on the group to disable every item, or on a single RadioGroupItem.

API reference

Built on Base UI Radio. The tables below cover the props this library adds or changes — every other prop is forwarded to the underlying Base UI part; see the Base UI Radio API reference for the full list.

RadioGroup

PropTypeDefaultDescription
valueany—Controlled selected value.
defaultValueany—
onValueChange(value: any) => void—
disabledbooleanfalse
styleStyleXStyles—StyleX styles merged last — always win over the component’s own styles.

RadioGroupItem

PropTypeDefaultDescription
value (required)any—
disabledbooleanfalse
styleStyleXStyles—StyleX styles merged last — always win over the component’s own styles.

Was this page helpful?