---
url: /components/checkbox/guidelines.md
description: >-
  Checkboxes allow users to select one or more items from a set. Checkboxes can
  turn an option on or off.
---

# Checkbox

Checkboxes allow users to select one or more items from a set. Checkboxes can turn an option on or off.

[Overview](overview.md) · [Specs](specs.md) · **Guidelines** · [Accessibility](accessibility.md)

![A list of burger additions represented with checkboxes.](/assets/83670e25-mg0yt1n6-1.BJ3oe2A8.webp)

Checkboxes in a list of items

## Usage

Use checkboxes to: 

* Select one or more options from a list
* Present a list containing sub-selections
* Turn an item on or off in a desktop environment
* Visually group similar options together

![List of 80's songs indicating choice through checkbox selection.](/assets/b2ddf6d6-mg0vnl39-2.D4WVK4CA.webp)

Checkboxes select multiple, related options

Checkboxes should be used instead of [switches](../switch/overview.md "Switches toggle the state of an item on or off.") if multiple, related options can be selected from a list. Checkboxes visually group similar items effectively and take up less space than switches.

::: tip Do
![List indicating choice with checkbox selection.](/assets/eae65022-mg0vok05-3_do.JUKFXnEu.webp)

Checkboxes let users select one or more options from a list. A parent checkbox allows for easy selection or deselection of all items.
:::

::: danger Don't
![A list with multiple switches selected.](/assets/714a6f39-mg0vwf9n-4_dont.D3j_FmHM.webp)

If a list consists of multiple options, don't use switches. Instead, use checkboxes. Checkboxes imply the items are related, and take up less visual space.
:::

### Alternate selection controls

Checkboxes, [radio buttons](../radio-button/overview.md "Radio buttons let people select one option from a set of options."), and [switches](../switch/overview.md "Switches toggle the state of an item on or off.") are the three main selection controls. They all help people make choices, like selecting options or switching settings on or off.

* Use checkboxes to select multiple related options in a list.
* Use radio buttons to select a single option in a list.
* Use switches to select standalone or more verbose options in a list, like settings.

![Diagram of 2 radio buttons, one selected and one unselected.](/assets/5cdcb7dc-mcypcjyf-5.b6-pc2kF.webp)

Radio buttons

![Diagram of 2 switches, one selected and one unselected.](/assets/431b8b43-mg0vwj88-6.D1pTRTwa.webp)

Switches

## Anatomy

![Diagram of checkbox indicating the 2 parts of its anatomy.](/assets/745c61db-mcypfx6t-7.B-6IoKzE.webp)

1\. Container

2\. Icon

## Responsive layout

In [expanded breakpoints](../../foundations/layout/breakpoints/expanded.md "Window widths 840dp to 1199dp, such as a tablet or foldable in landscape orientation, or desktop."), placing checkboxes within a contained region such as a [side sheet](../side-sheets/overview.md "Side sheets show secondary content anchored to the side of the screen.") can help group related controls and available actions.

![Desktop screen showing music albums and a side sheet containing checkboxes for filtering music genres.](/assets/a262b730-mg0vp83b-8.omHQqbBc.webp)

A side sheet can group related controls on larger screens

## Behavior

Multiple checkboxes in a list can be selected.

<video controls src="https://firebasestorage.googleapis.com/v0/b/design-spec/o/projects%2Fgoogle-material-3%2Fimages%2Flwj3f7ot-GM3-Components-Checkbox-Guidelines-1-v01.mp4?alt=media" aria-label="Using checkboxes to select a list of extra ingredients, like pickles and tomatoes, to add to a meal."></video>

Selecting multiple items in a list using checkboxes

Checkboxes can have a parent-child relationship with other checkboxes.

* When the parent checkbox is checked, all child checkboxes are checked
* If a parent checkbox is unchecked, all child checkboxes are unchecked
* If some, but not all, child checkboxes are checked, the parent checkbox becomes an indeterminate checkbox. Checking an indeterminate checkbox checks all child items.

<video controls src="https://firebasestorage.googleapis.com/v0/b/design-spec/o/projects%2Fgoogle-material-3%2Fimages%2Flwj3h4ri-GM3-Components-Checkbox-Guidelines-2-v01.mp4?alt=media" aria-label="Checking parent checkbox also checks child items. Unchecking one child item makes parent indeterminate."></video>

Use a parent checkbox to make it more efficient to select many items

When selected, a checkbox clearly and instantly communicates its selected state.

If used to turn something on or off, the action should be immediately executed.

<video controls src="https://firebasestorage.googleapis.com/v0/b/design-spec/o/projects%2Fgoogle-material-3%2Fimages%2Flwj3iba1-GM3-Components-Checkbox-Guidelines-3-v01.mp4?alt=media" aria-label="Selecting a checkbox for turning on dark mode immediately changes the phone theme."></video>

Turning an item on or off using a checkbox
