Switch/Toggle

An input for toggling between on or off states.

switch-image-android

Usage

Reference Material Design for general guidance when designing for Android.

Design properties

Property Values Default
State Variant Enabled | Hovered | Focused | Pressed | Disabled Enabled
Selected Variant False | True True

Types

Default

For switch labels, use the List component in Figma.

Writing guidelines

Due to such limited space, keep label strings to 1-2 words and use a tooltip if you need to provide additional details.

The switch itself already implies a binary “on” / “off” action, so labels should align with that action. The following best practices apply to copy for switches:

  • Stay concise, keep labels to 1-2 words
  • Labels should indicate the name of the feature, with the understanding that it turns on and off (Unless there is particular confusion, the label shouldn’t need an action verb).
  • Tooltips should include action verbs that indicate the change that will happen when toggled.

Changelog

Date

Version

Notes

Aug 1, 2025

2.0.0

Updated to reflect M3 changes

Feb 15, 2023

1.0.0

Initial draft of guidance