Source: Apple Inc. Canonical content at https://developer.apple.com/design/human-interface-guidelines/controls. 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.
Controls
Anatomy
-
In Control Center, a control displays its symbol and, at larger sizes, its title and value.
-
On the Lock Screen, a control displays its symbol.
-
On iPhone devices with a control assigned to the Action button, pressing and holding it displays the control’s symbol in the Dynamic Island, as well as its value (if present).
Best practices
Offer controls for actions that provide the most benefit without having to launch your app.
Update controls when someone interacts with them, when an action completes, or remotely with a push notification.
Choose a descriptive symbol that suggests the behavior of the control.
Use symbol animations to highlight state changes.
Select a tint color that works with your app’s brand.
Help people provide additional information the system needs to perform an action.
Provide hint text for the Action button.
If your control title or value can vary, include a placeholder.
Hide sensitive information when the device is locked.
Require authentication for actions that affect security.
Camera experiences on a locked device
Use the same camera UI in your app and your camera experience.
Provide instructions for adding the control.
Platform considerations
Resources
Related
Developer documentation
Change log
For the complete guidance, including worked examples and illustrations, see the canonical page: https://developer.apple.com/design/human-interface-guidelines/controls