🔘 Radio Button — Documentation

🧭 When to Use / When Not to Use

Use When

• The user must select exactly one option from a list.
• All available options should be visible at once.
• Choices are mutually exclusive and the decision is important.
• You want to avoid the ambiguity of dropdown selections.

Avoid When

• Users can choose multiple options → use Checkboxes.
• Space is limited → use a Dropdown with radio items.
• Options are a simple binary toggle → use a Switch.
• You need progressive steps → use Stepper / Wizard.

🎨 Considerations

Visibility & Clarity

• Display all radio options together for clear comparison.
• Keep option labels short and meaningful.
• Use helper description text when extra context is needed.

Layout