Controls
Offer controls that people place in Control Center, on the Lock Screen, and on the Action button to quickly perform an action from your app.
Overview
Controls act as a button that initiates an action from your app or opens your app to a specific view, or as a toggle. A toggle can turn a light on and off, or open and close a garage door. People place controls in prominent locations to personalize how they use their devices:
On devices with an Action button, people can place a controls action in the Action button.
On iPhone and iPad, people place controls in Control Center and on the Lock Screen.
On Mac, people place controls from your macOS app in Control Center or as menu bar items.
On Apple Watch, people place controls from your watchOS app or from a paired iPhone in Control Center or the Smart Stack. If you offer watchOS app in addition to an iPhone app and both apps offer controls, people can only place controls from your watchOS app in Control Center or the Smart Stack.
To offer a control for your app, use WidgetKit API to configure and update the control, create its layout with SwiftUI, and perform its action using App Intents. For more information about the App Intents framework, refer to Making actions and content discoverable and widely available.
Topics
Essentials
Developing a WidgetKit strategyCreating a widget extensionEmoji Rangers: Supporting Live Activities, interactivity, and animations
Setup and configuration
Creating controls to perform actions across the systemAdding refinements and configuration to controlsStaticControlConfigurationAppIntentControlConfigurationControlCenterControlInfoControlWidgetButtonControlWidgetToggle