Black Lives Matter. Support the Equal Justice Initiative.
Skip to main contentCarbon Design System

Radio button

Use radio buttons when you have a group of mutually exclusive choices and only one selection from the group is allowed.

Overview

Radio buttons represent a group of mutually exclusive choices, compared to checkboxes that allow users to make one or more selections from a group. In use cases where only one selection of a group is allowed, use the radio button component instead of the checkbox.

Live demo

Radio Button heading
RadioButtonGroup
orientation
labelPosition

Format

Headings

If necessary, a heading can accompany a set of radio buttons to provide further clarity for the user. Use sentence-style capitalization (only the first word in a phrase and any proper nouns capitalized).

Labels

Always use a clear and concise label for radio buttons. Be explicit about the action that will follow if the radio button is selected. Labels appear to the right of radio buttons. Use sentence-style capitalization (only the first word in a phrase and any proper nouns capitalized) and no more than three words.

Default selection

A set of radio buttons should default to having one option selected. Never display them without a default selection.

Feedback

Help us improve this component by providing feedback, asking questions, and leaving any other comments on GitHub.