Switch/Toggle

An input for toggling between on or off states.

iOS-toggle-image

Usage

Reference HIG for general guidance when designing for iOS.

Design properties

Property Values Default
Switch Variant True | False False
Disabled Variant True | False False

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 toggle itself already implies a binary “on” / “off” action, so labels should align with that action. The following best practices apply to copy for toggles:

  • 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.1.0

Updated to reflect new iOS library

Apr 17, 2025

2.0.0

Simplified template

Feb 15, 2023

1.0.0

Initial draft of button guidance