<!--
{
  "availability" : [
    "watchOS: 5.0.0 - 11.0.0"
  ],
  "documentType" : "article",
  "framework" : "SiriKit",
  "identifier" : "/documentation/SiriKit/displaying-shortcut-information-in-a-siri-watch-face-card",
  "metadataVersion" : "0.1.0",
  "role" : "article",
  "title" : "Displaying Shortcut Information in a Siri Watch Face Card"
}
-->

# Displaying Shortcut Information in a Siri Watch Face Card

Display and customize watch-specific shortcut information with a default card template.

## Discussion

The Siri watch face displays a relevant shortcut in a card that can provide the following information:

- App icon and name (supplied by the system)
- Title, subtitle, and custom image (supplied by the intent or user activity used to create the shortcut, or by an [`INDefaultCardTemplate`](/documentation/Intents/INDefaultCardTemplate) object)

> 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 <doc://com.apple.documentation/documentation/WidgetKit>, <doc://com.apple.documentation/documentation/WidgetKit/Widget-Suggestions-In-Smart-Stacks>, and <doc://com.apple.documentation/documentation/AppIntents>. For more information about migrating your SiriKit code to App Intents, refer to <doc://com.apple.documentation/documentation/WidgetKit/Migrating-from-SiriKit-Intents-to-App-Intents> and <doc://com.apple.documentation/documentation/SiriKit/soup-chef-with-app-intents-migrating-custom-intents>.

### Display Intent-Based Shortcuts

When your app uses an [`INIntent`](/documentation/Intents/INIntent) object to create the shortcut, the system retrieves the intent’s title and subtitle from the intent settings defined in the intent definition file. To include an image, call [`setImage:forParameterNamed:`](/documentation/Intents/INIntent/setImage:forParameterNamed:) on the intent and pass in an [`INImage`](/documentation/Intents/INImage).

The listing below sets the image for a order soup intent in the Soup Chef sample app.

```swift
orderSoupIntent.setImage(INImage(named: menuItem.iconImageName), forParameterNamed: \OrderSoupIntent.soup)
```

### Display User Activity-Based Shortcuts

When your app uses an <doc://com.apple.documentation/documentation/Foundation/NSUserActivity> object to create the shortcut, the system retrieves the title from the title property of the user activity. To specify a subtitle, create an <doc://com.apple.documentation/documentation/CoreSpotlight/CSSearchableItemAttributeSet> with the content type of `kUTTypeItem`, and set the <doc://com.apple.documentation/documentation/CoreSpotlight/CSSearchableItemAttributeSet/contentDescription> property. To include an image, set the <doc://com.apple.documentation/documentation/CoreSpotlight/CSSearchableItemAttributeSet/thumbnailData> on the attribute set.

The listing below sets the title, subtitle, and image for the NSUserActivity object.

```swift
import CoreSpotlight
import MobileCoreServices

let userActivity = NSUserActivity(activityType: "com.myapp.myactivity")
userActivity.title = "Title"

let attributes = CSSearchableItemAttributeSet(itemContentType: kUTTypeItem as String)
attributes.contentDescription = "Subtitle"
attributes.thumbnailData =  imageLiteral(resourceName: "custom-image").pngData()

userActivity.contentAttributeSet = attributes
```

### Use Card Templates

If you want to show a UI specific to the watch—for example, to display a shortcut’s title that is shorter than the one Siri displays on the user’s iPhone or iPad—provide the relevant shortcut a default card template by setting the [`watchTemplate`](/documentation/Intents/INRelevantShortcut/watchTemplate) property. The template allows your app to customize the [`title`](/documentation/Intents/INDefaultCardTemplate/title), [`subtitle`](/documentation/Intents/INDefaultCardTemplate/subtitle), and [`image`](/documentation/Intents/INDefaultCardTemplate/image). (You cannot change or remove the app icon and name shown in the card.)

The listing below sets the template for an order intent in the Soup Chef sample app.

```swift
let order = Order(quantity: 1, menuItem: menuItem, menuItemOptions: [])
let orderIntent = order.intent

guard let shortcut = INShortcut(intent: orderIntent) else { return nil }

let suggestedShortcut = INRelevantShortcut(shortcut: shortcut)

let localizedTitle = NSString.deferredLocalizedIntentsString(with: "ORDER_LUNCH_TITLE") as String
let template = INDefaultCardTemplate(title: localizedTitle)
template.subtitle = NSString.deferredLocalizedIntentsString(with: menuItem.shortcutNameKey + "_SUBTITLE") as String
template.image = INImage(named: menuItem.iconImageName)

suggestedShortcut.watchTemplate = template
```

The code above creates the Siri watch face card shown in the figure below. To download the complete sample code, see <doc://com.apple.documentation/documentation/SiriKit/soup-chef-accelerating-app-interactions-with-shortcuts>.

![A screenshot of the Siri watch face suggesting the order lunch relevant shortcut.](images/com.apple.sirikit/media-3030287@2x.png)

The system displays the information in one of four layouts based on the information your app provides in the card template. For instance, if you don’t provide an image, the system uses a layout that displays only the title and subtitle fields. And if you provide only the title, the system uses a layout that can wrap the title on two lines.

![An image showing four layouts for a Siri watch face card. The first layouts shows a title, subtitle, and image. The second layout shows a title and subtitle. The third layout shows a title and image. The fourth layout shows the title only, wrapping to two lines.](images/com.apple.sirikit/media-3030290@2x.png)

## See Also

  <doc://com.apple.sirikit/documentation/SiriKit/soup-chef-accelerating-app-interactions-with-shortcuts>



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)