Radio
Radio button is a form control for making a single selection from a short list of options.
On this page
On this page
Usage
Use a radio button in a radio group to allow users to select one option from a short list of options.
See the radio group guidelines for more information about usage.
States
Radio buttons have static dimensions and three different states when checked or unchecked: rest (default), focus, and disabled.
Best practices
- A radio button may not be used on its own: it must be rendered in a group of related radio buttons using a radio group.
- Radio buttons cannot be unchecked, so only use radio buttons when a selection is required
- An individual radio should not have its own validation message or style. Instead, show a validation message on the radio group. For more information, see the Validation Message section in the Forms documentation.
- An individual radio button cannot be marked as required. Instead, make a selection required using the radio group. For more information, see the Required field indicator in the Forms documentation.