# Toggles

Source: https://developer.apple.com/design/human-interface-guidelines/toggles
Skill: hig-components-controls
Snapshot: 2025-02-02

---
<!-- hig-doctor:attribution -->
> **Source**: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/toggles.
> This file is a structured index of that content, snapshot 2025-02-02.
> Apple HIG text and imagery are © Apple Inc.; this repository provides organization and cross-referencing for AI agent consumption only.

# Toggles

## Best practices

**Use a toggle to help people choose between two opposing values that affect the state of content or a view.**

**Clearly identify the setting, view, or content the toggle affects.**

**Make sure the visual differences in a toggle’s state are obvious.**

## Platform considerations

### iOS, iPadOS

**Use the switch toggle style only in a list row.**

**Change the default color of a switch only if necessary.**

**Outside of a list, use a button that behaves like a toggle, not a switch.**

**Avoid supplying a label that explains the button’s purpose.**

### macOS

**Use switches, checkboxes, and radio buttons in the window body, not the window frame.**

#### Switches

**Prefer a switch for settings that you want to emphasize.**

**Within a grouped form, consider using a mini switch to control the setting in a single row.**

**In general, don’t replace a checkbox with a switch.**

#### Checkboxes

**Use a checkbox instead of a switch if you need to present a hierarchy of settings.**

**Consider using radio buttons if you need to present a set of more than two mutually exclusive options.**

**Consider using a label to introduce a group of checkboxes if their relationship isn’t clear.**

**Accurately reflect a checkbox’s state in its appearance.**

#### Radio buttons

**Prefer a set of radio buttons to present mutually exclusive options.**

**Avoid listing too many radio buttons in a set.**

**To present a single setting that can be on or off, prefer a checkbox.**

**Use consistent spacing when you display radio buttons horizontally.**

---

<!-- hig-doctor:canonical-footer -->
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/toggles