Controls / The visual dictionary

Switch.

Turns a setting on or off immediately.

Also calledtoggle switchon off switch
01

See it in context

UI illustration

A switch displays a binary state with a movable thumb. It works best for a setting whose effect occurs as soon as the switch changes, such as enabling notifications.

When to use it

Label the setting rather than the action and apply the change immediately.

Know the difference

Checkboxes frequently collect form choices for later submission; switches commonly change a setting now.

WebiOSiPadOSAndroidmacOSWindowsLinuxwatchOSWear OStvOSAndroid TVvisionOS

Web · Windows · Linux

Expose checked, mixed, or pressed state using the corresponding native control or accessibility semantics. Space normally changes the focused control.

iOS · iPadOS · Android · macOS

Use the native selection control appropriate to immediate settings or form choices. A switch and a checkmark can express different interaction models.

watchOS · Wear OS

On a watch, use a short label and a generous target within the small display. Crown or rotary input can supplement touch for adjustable values.

tvOS · Android TV

On TV, give the focused control a prominent visual state and support remote activation; hover and precise pointer targeting are not assumed.

visionOS

In spatial interfaces, use a comfortably targetable control with a clear focus response for indirect gaze-and-pinch interaction.

Primary documentation for the pattern and its platform conventions.