Select one or more from a list of options

Use checkboxes to let users select one or more options from a list when multiple selections are valid.

When to use

Use this pattern when:

  • Users can select multiple options from a predefined list
  • All options that apply should be selected
  • The list of options is relatively short (up to ~7 items)
  • Each option is independent of the others

Considerations

  • Use clear, concise labels for each option
  • Include help text like “Choose all that apply” to indicate multiple selection
  • Consider the order of options (most common first, alphabetical, etc.)
  • For longer lists, consider a different component like multi-select dropdown
  • Ensure adequate touch targets for mobile users
View old example docs