--- title: Defining Relevant Shortcuts for the Siri Watch Face framework: sirikit role: article role_heading: Article path: sirikit/defining-relevant-shortcuts-for-the-siri-watch-face --- # Defining Relevant Shortcuts for the Siri Watch Face Inform Siri when your app’s shortcuts may be useful to the user. ## Overview Overview The Siri watch face can suggest shortcuts to the user based on a situation, time of day, or location. You determine which actions in your app are pertinent to the user and may be something they’d like to do in the future, such as starting a workout when arriving at a gym. Your app tells Siri about these actions by specifying them as relevant shortcuts. An iOS app can set relevant shortcuts and display them on the Siri watch face, whether it has a companion watchOS app or not. If a watchOS app and its iOS companion both set relevant shortcuts, the Siri watch face uses the list of shortcuts set most recently across either app. important: The Siri Watch Face is available in watchOS 11 and earlier. To make content available in the Smart Stack on Apple Watch using widgets, refer to WidgetKit, Increasing the visibility of widgets in Smart Stacks, and App Intents. For more information about migrating your SiriKit code to App Intents, refer to Migrating widgets from SiriKit Intents to App Intents and Soup Chef with App Intents: Migrating custom intents. Create a Relevant Shortcut To let Siri know about relevant shortcuts for your app, start by creating an INIntent with a system-provided or custom intent, or an NSUserActivity object for each action. Next, create an INShortcutReference object for each intent and user activity. Use the shortcut to create an INRelevantShortcutRole object, and set the shortcutRole to provide a hint to Siri as to the purpose of the shortcut: to perform an action or display information. // Add an intent to the list of suggestions. To create // a shortcut from an intent, the intent must be valid. if let shortcut = INShortcut(intent: startWorkoutIntent) { let relevantShortcut = INRelevantShortcut(shortcut: shortcut) relevantShortcut.shortcutRole = INRelevantShortcutRole.action } Add Relevance Providers To give Siri a hint about when to suggest the shortcut to the user, add one or more providers to the relevanceProviders property on the relevant shortcut. Relevance providers let you specify parameters such as a particular situation, date, time, and location that indicate the shortcut may be relevant to the user. For example, you can instruct Siri to suggest starting a workout when the user arrives at the gym. // Add an intent to the list of suggestions. To create // a shortcut from an intent, the intent must be valid. if let shortcut = INShortcut(intent: startWorkoutIntent) { let relevantShortcut = INRelevantShortcut(shortcut: shortcut) relevantShortcut.shortcutRole = INRelevantShortcutRole.action // Create a location provider for Apple Park Fitness Center. let location = CLLocationCoordinate2D(latitude: 37.336_971, longitude: -122.013_050) let region = CLCircularRegion(center: location, radius: 0.1, identifier: "Apple Park Fitness Center") let locationProvider = INLocationRelevanceProvider(region: region) relevantShortcut.relevanceProviders = [locationProvider] } Don’t combine an INDailyRoutineRelevanceProvider for a time-based situation with an INDateRelevanceProvider, like INDailyRoutineRelevanceProvider.Situation.evening and 8 p.m.; the outcome can be unpredictable. Instead, provide multiple relevant shortcuts for each scenario, that is, provide a relevant shortcut for INDailyRoutineRelevanceProvider.Situation.evening and a second one for 8 p.m. Applying multiple locations relevance providers to a relevant shortcut creates similar problems. Instead, provide a relevant shortcut for each location. important: Your app should donate an intent or user activity as a shortcut each time the user performs an action in your app, even when your app provides the shortcut as a relevant shortcut. The donation helps the system determine when it should suggest the relevant shortcut to the user. For more information about donations, see Donating Shortcuts. Set Relevant Shortcuts Continue creating the relevant shortcuts for your app, storing each one in an array. After you’ve created and stored the shortcuts, inform Siri of the relevant shortcuts by using the default relevant shortcut store to call setRelevantShortcuts(_:completionHandler:), passing in the array of relevant shortcuts. var relevantShortcuts:[INRelevantShortcut] = [] // Add an intent to the list of suggestions. To create // a shortcut from an intent, the intent must be valid. if let shortcut = INShortcut(intent: startWorkoutIntent) { let relevantShortcut = INRelevantShortcut(shortcut: shortcut) relevantShortcut.shortcutRole = INRelevantShortcutRole.action // Create a location provider for Apple Park Fitness Center. let location = CLLocationCoordinate2D(latitude: 37.336_971, longitude: -122.013_050) let region = CLCircularRegion(center: location, radius: 0.1, identifier: "Apple Park Fitness Center") let locationProvider = INLocationRelevanceProvider(region: region) relevantShortcut.relevanceProviders = [locationProvider] relevantShortcuts.append(relevantShortcut) } INRelevantShortcutStore.default.setRelevantShortcuts(relevantShortcuts) { (error) in if let error = error { print("Failed to set relevant shortcuts. \(error))") } else { print("Relevant shortcuts set.") } } Replace Relevant Shortcuts There isn’t a way to add relevant shortcuts to the list already set by your app. Instead, you must replace the list by following the same steps previously mentioned: Gather the actions (as user activities or intents) and create an array of INRelevantShortcut objects. Pass the array to setRelevantShortcuts(_:completionHandler:). When you’ve completed these steps, the new set of relevant shortcuts takes the place of the previous one. If you want to delete all relevant shortcuts defined by your app, call setRelevantShortcuts(_:completionHandler:), passing in an empty array. Replace the list when your app needs to add or remove a relevant shortcut. It isn’t necessary to replace the list more than once a day, and resubmitting the same set of relevant shortcuts more often provides no benefits. ## See Also ### Articles - [Adding User Interactivity with Siri Shortcuts and the Shortcuts App](sirikit/adding-user-interactivity-with-siri-shortcuts-and-the-shortcuts-app.md) - [Deleting Donated Shortcuts](sirikit/deleting-donated-shortcuts.md) - [Dispatching intents to handlers](sirikit/dispatching-intents-to-handlers.md) - [Improving Siri Media Interactions and App Selection](sirikit/improving-siri-media-interactions-and-app-selection.md) - [Improving interactions between Siri and your messaging app](sirikit/improving-interactions-between-siri-and-your-messaging-app.md) - [Registering Custom Vocabulary with SiriKit](sirikit/registering-custom-vocabulary-with-sirikit.md) - [Confirming the Details of an Intent](sirikit/confirming-the-details-of-an-intent.md) - [Handling an Intent](sirikit/handling-an-intent.md) - [Resolving the Parameters of an Intent](sirikit/resolving-the-parameters-of-an-intent.md) - [Generating a List of Ride Options](sirikit/generating-a-list-of-ride-options.md) - [Handling the Ride-Booking Intents](sirikit/handling-the-ride-booking-intents.md) - [Donating Reservations](sirikit/donating-reservations.md) - [Specifying Synonyms for Your App Name](sirikit/specifying-synonyms-for-your-app-name.md) - [Intent Phrases](sirikit/intent-phrases.md) - [Localizing Your Vocabulary for Chinese Dialects](sirikit/localizing-your-vocabulary-for-chinese-dialects.md)