Controls / The visual dictionary

Radio button.

Selects one option from a mutually exclusive group.

Also calledoption buttonradio option
01

See it in context

UI illustration

A radio button belongs to a named group whose choices cannot be active together. Selecting another option clears the previous one, so the set communicates a single decision.

When to use it

Present related options under a group label and allow only one selected value.

Know the difference

An isolated on/off setting is a switch or checkbox, not usually a radio button.

WebiOSiPadOSAndroidmacOSWindowsLinux

Web · Windows · Linux

Expose checked, mixed, or pressed state using the corresponding native control or accessibility semantics. Space normally changes the focused control.

iOS · iPadOS · Android · macOS

Use the native selection control appropriate to immediate settings or form choices. A switch and a checkmark can express different interaction models.

Primary documentation for the pattern and its platform conventions.