Radio

Documentation Index

Fetch the complete documentation index at: https://docs.cognite.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Radio

​

When to use

• When users need to make a single selection from a small set of predefined options.
• When it’s important that all options are immediately visible, helping users compare choices side by side.
• When the options are mutually exclusive (only one can be selected at a time).

​

When to use something else

• Multiple selections: use Checkbox.
• More than ~five options or tight space: use Select or Combobox.
• Binary on/off with immediate effect: use Switch.
• Long lists with search: use Combobox.

​

Dos and don’ts

• Do pair with a label that describes what the user is selecting.
• Do use the radio button group to group related options.
• Don’t use the radio button group to group unrelated options.
• Don’t use the radio button group to group more than five options.
• Don’t use the radio button group when the options are not mutually exclusive.

​

Radio vs Radio + card

• Use a plain radio button when the options are simple labels and the choice doesn’t need much explanation — a list of sizes, a frequency, etc…
• Use the card container when:
  • Each option needs supporting text or a description to be understood.
  • The options represent meaningfully different paths (e.g. plan tiers, configuration modes, templates, roles).
  • The visual weight of the choice should match its importance in the flow.
  • The card makes each option feel like a distinct selection rather than an item in a list — that framing is only appropriate when the options are genuinely distinct and the user needs to consider them, not just pick one quickly.

​

Often used with

• Group Label / legend, per-option Label, Helper text; Card variant for heavy options.