We use cookies on our websites to deliver our online services. Details about how we use cookies and how you may disable them are set out in our Privacy Statement. By using this website you agree to our use of cookies.

Skip to content
Patternfly Logo

Switch

A switch toggles the state of a setting (between on and off). Switches and checkboxes can often be used interchangeably, but the switch provides a more explicit, visible representation on a setting.

Usage

It is assumed that when a user toggles a switch, the change will save automatically without the need for additional action (like clicking a "Save" button).

A side-by-side comparison of a basic switch and a switch without a label. The basic switch uses both a form label and a switch label, while the switch without a label uses a form label and replaces the switch label with a checkmark inside the switch itself
  1. Form label: Indicates what the switch turns on or off
  2. Switch label: Indicates whether the switch itself is turned on or off
  3. Switch without label: Indicates the state of a switch with a checkmark inside the switch itself, used in place of a switch label
  4. Switch with label and checkmark: Indicates the state of a switch with a checkmark inside the switch itself and label with additional message

All switch types display their state (on or off) through different methods and locations. A basic switch communicates its state with an exterior switch label added to its right, while a switch without a label uses a checkmark to communicate its state from inside the switch itself.

General guidelines

  • Use a basic switch by default unless space is limited, then use a switch without a label.
  • Add a form label in front of your switch to specify what setting a switch turns on or off, such as Wi-fi or Bluetooth.
  • If you're using a basic switch, add switch labels to clarify between toggled settings, such as On and Off.
  • Don't include the state of a switch in a label if you're using a switch with a label and a checkmark.
  • Don’t use a switch if the options you’re presenting to the user are anything other than “on” or “off.” Instead, use radio buttons.

When to use switches versus checkboxes

A switch changes an option and saves it simultaneously, while checkboxes require a separate action to save the selection, such as pressing a “Submit” or “Save” button.

Follow these guidelines for when to use a switch versus a checkbox:

  • Use checkboxes when options do not save automatically and require the user to perform an additional action to save changes (in this case, pressing the “Save changes” button).

    Example 1 of do's and don'ts for using a checkbox vs. a switch
  • Use a switch for situations where you are turning a series of one or more independent options on or off.

    Example 2 of do's and don'ts for using a checkbox vs. a switch
  • Use checkboxes when you may have an intermediate state where you can select all, none, or some actions.

    Example 3 of do's and don'ts for using a checkbox vs. a switch

View source on GitHub