<!--
{
  "availability" : [
    "watchOS: 7.0.0 - 27.2.0"
  ],
  "documentType" : "symbol",
  "framework" : "ClockKit",
  "identifier" : "/documentation/ClockKit/CLKComplicationDescriptor/init(identifier:displayName:supportedFamilies:userActivity:)",
  "metadataVersion" : "0.1.0",
  "role" : "Initializer",
  "symbol" : {
    "kind" : "Initializer",
    "modules" : [
      "ClockKit"
    ],
    "preciseIdentifier" : "s:So25CLKComplicationDescriptorC8ClockKitE10identifier11displayName17supportedFamilies12userActivityABSS_SSSaySo0A6FamilyVGSo06NSUserK0Ctcfc"
  },
  "title" : "init(identifier:displayName:supportedFamilies:userActivity:)"
}
-->

# init(identifier:displayName:supportedFamilies:userActivity:)

Returns a new complication descriptor with an associated user activity.

```
convenience init(identifier: String, displayName: String, supportedFamilies: [CLKComplicationFamily], userActivity: NSUserActivity)
```

## Parameters

`identifier`

A string that uniquely identifies the descriptor.

`displayName`

A localized name that ClockKit shows to the user to identify complications from the descriptor.

`supportedFamilies`

The families that support this type of complication. Note that different descriptors can support different sets of families.

`userActivity`

A user activity object that represents the state of the app at a moment in time.

## Discussion

If the user taps on a complication specified by this descriptor, the system launches the app and calls <doc://com.apple.documentation/documentation/WatchKit/WKExtensionDelegate/handle(_:)-5pyj1>, passing the user activity. Your <doc://com.apple.documentation/documentation/WatchKit/WKExtensionDelegate/handle(_:)-5pyj1> method should update the app so that it’s in the specified state.

Because the system can pass configurations as part of a shared watch face, only include data useable by any instance of the app. For example, avoid using identifiers that might change between users, like an index into the user’s favorites list. Instead, use items that remain constant across all copies of the app, like unique string identifiers.

---

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)