Skip to main contentCarbon Design System

Radio button

White
Gray 10
Gray 90
Gray 100
Radio button
Radio Button heading
RadioButtonGroup
orientation
labelPosition

General guidance

Radio buttons are used when a list of two or more options are mutually exclusive, meaning the user must select only one option.

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.