<!--
{
  "availability" : [
    "iOS: 14.0.0 -",
    "iPadOS: 14.0.0 -",
    "macCatalyst: 14.0.0 -",
    "watchOS: 10.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ClockKit",
  "identifier" : "/documentation/ClockKit",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "ClockKit"
    ],
    "preciseIdentifier" : "ClockKit"
  },
  "title" : "ClockKit"
}
-->

# ClockKit

Display app-specific data on the clock face.

## Overview> Important:
> ClockKit-based complications are deprecated in watchOS 10 and later. Use <doc://com.apple.documentation/documentation/WidgetKit> to create complications. For more information, see <doc://com.apple.clockkit/documentation/ClockKit/CLKComplicationDataSource#Migrating-to-WidgetKit>.

Use the ClockKit framework to implement complications for your app. *Complications* are small interface elements that appear on a watch face and provide quick access to data that people frequently use. Your app defines complications using timeline entries that provide a template for the complication’s appearance and the date ClockKit displays it. The system updates the appearance of your complication based on the timeline.

ClockKit defines the size and placement of the complications on each watch face. The following image depicts the layout of the Modular watch face, which has space for five different complications: one large and four small.

![An illustration showing the space for one large and four small complications on the Modular watch face.](images/com.apple.clockkit/media-3571054@2x.png)

ClockKit organizes complications into families based on their size and style, and provides a variety of templates for each family. Use the templates to display text, images, and graphical gauges.

### Improve your app with complications

Complications provide a unique way to interact with your users. Consider creating complications, even if they only act as a launcher for your watchOS app. A complication on the active watch face provides:

- Vital information when the user glances at their watch.
- A rapid launch of your app to a specific screen when the user taps on the complications.
- The ability to perform background tasks, keeping your complication and app up to date.

When your app has a complication on the active watch face, watchOS tries to keep your watch app suspended in memory. The system can wake your app from the background quickly when the user wants to interact with it. ClockKit also wakes your app when the user taps your complication. If you use a user activity configuration, ClockKit passes the user activity to your app after waking it.

The system also gives apps with active complications more opportunities for background refresh tasks. You can use these tasks to keep the content of your watchOS app and your complications up to date and accurate.

## Topics

### Migration Support

  <doc://com.apple.documentation/documentation/WidgetKit/Converting-A-ClockKit-App>

[`CLKComplicationDataSource`](/documentation/ClockKit/CLKComplicationDataSource)

A protocol that provides ClockKit with information about your complication.

[`CLKDefaultComplicationIdentifier`](/documentation/ClockKit/CLKDefaultComplicationIdentifier)

An identifier representing a default complication.

[`CLKComplicationDescriptor`](/documentation/ClockKit/CLKComplicationDescriptor)

A descriptor that defines a complication and the families that it supports.

[`CLKAllComplicationFamilies`](/documentation/ClockKit/CLKAllComplicationFamilies)

Returns an array containing all possible values of the complication family enumeration.

### Face Sharing

[Sharing an Apple Watch face](/documentation/ClockKit/sharing-an-apple-watch-face)

Distribute a customized watch face to Apple Watch users.

[`CLKWatchFaceLibrary`](/documentation/ClockKit/CLKWatchFaceLibrary)

An object for importing watch faces that the app provides.

### Deprecated

[Deprecated articles and symbols](/documentation/ClockKit/deprecated-articles-and-symbols)



---

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)