Components

Checkbox

Checkboxes let people pick any number of options from a list, or turn one option on before they submit.

Example

Light

Dark

When to use

  • Use checkboxes when people can pick several options, or none.
  • Use radio buttons when exactly one option must be picked.
  • Use a toggle when the change takes effect right away, with no submit.

Variants and states

Variant or stateUse
UncheckedThe option is off.
CheckedThe option is on. The fill and the mark both change, so the state is not color alone.
DisabledThe option can't be changed right now. Say why nearby.

Guidance

Do

Make the whole label clickable, not just the box.

Don't

Leave a 16px box as the only target.

Do

Group related checkboxes under a fieldset with a legend that asks the question.

Don't

Float a list of checkboxes with no group label.

Do

Write labels as positive statements: "Bring the awning lights".

Don't

Use negatives like "Don't skip the lights", which make the checked state confusing.