Complications

Complications display timely and relevant information about your app on the watch face. All watch faces have at least one complication; some have four or more. The system organizes the complications into several different families. The family defines the complication’s general size and shape. Each watch face specifies which family it supports in each complication slot.

Your app provides the data for a complication in the form of a timeline. The system uses this timeline to determine which data to display based on the current time of day. Apps can update their timelines a limited number of times each day, and the system stores a limited number of timeline entries for each app.

The system draws the complications using templates that define the layout and appearance of the data from the timeline, and each complication family offers a variety of templates from which you can choose.

Support as many complication families as possible. Supporting all of the families ensures that your complication is available on all watch faces that display complications.

Display data that is useful and relevant. Watch faces have only a small number of slots available for complications. If your complication does not provide useful information, the user probably won’t install it. The most interesting and useful complications are ones whose data changes throughout the day, such as the Activity complication.

Decide what and when to display data. Each timeline entry has a time value that represents the time at which to display your data on the watch face, and different data sets might require different time values. For example, a meeting app might display information about an upcoming meeting before the meeting starts, but a weather app might display forecast information when it expects those conditions to occur. Choose times that enhance the usefulness of the data.

Size images to match the specific template. You must size the images you use for each template you support. For a list of image sizes, see Complication Images.

Provide complication bundles with realistic data. Users configure complications using the Apple Watch app on iOS, which uses complication bundles to display representative versions of your app’s complication. You supply the complication bundles for your app. When creating the bundles, use realistic placeholder data to convey how your complication will look when displayed on the watch face.

Always provide no-content images for your complication. The system displays a no-content image when the data for a complication is not available. For information about the size of no-content images, see Complication Images.

Choose a ring or gauge style that matches your data. Use the closed style to convey a value that is a percentage of a whole, such as a battery gauge. Use the open style when the minimum and maximum values are more arbitrary or do not represent a percentage of the whole, such as a speed indicator.

Circular

These templates display a small image or a few characters of text. They appear in the corner of the watch face (for example, in the Color watch face).

  • Ring Image
  • Ring Text
  • Simple Image
  • Simple Text
  • Stack Image
  • Stack Text

Modular Small

These templates display two stacked rows of content, an icon and content, a circular graph, or a single larger item (for example, the bottom row of complications on the Modular watch face).

  • Columns Text
  • Ring Image
  • Ring Text
  • Simple Image
  • Simple Text
  • Stack Image
  • Stack Text

Modular Large

These templates offer a large canvas for displaying up to three rows of content (for example, in the center of the Modular watch face).

  • Columns
  • Standard Body
  • Table
  • Tall Body

Utility Small

These templates occupy a rectangular area in corner of a watch face (for example, in the Chronograph or Simple watch faces). The content can include a glyph or icon, or it can include a circular graph.

  • Flat
  • Ring Image
  • Ring Text
  • Square

Utility Large

This template is primarily text-based, but also supports a glyph or icon placed to the left of the text. This template spans the bottom of the watch face (for example, the Utility or Motion watch faces).

  • Large Flat

Extra Large

These templates display larger text and images (for example, on the X-Large watch faces).

  • Ring Image
  • Ring Text
  • Simple Image
  • Simple Text
  • Stack Image
  • Stack Text

Graphic Corner

These templates display full-color images, text, and gauges in the corners of the Infograph watch face. Some of the templates also support multicolor text. The Infograph watch face is only available on Apple Watch Series 4.

  • Circular Image
  • Gauge Image
  • Gauge Text
  • Stack Text
  • Text Image

Graphic Circular

These templates display text, gauges, and full-color images in small circular areas on the Infograph and Infograph Modular watch faces. Some of the templates also support multicolor text. The Infograph and Infograph Modular faces are only available on Apple Watch Series 4.

  • Closed Gauge Image
  • Closed Gauge Text
  • Open Gauge Image
  • Open Gauge Text
  • Open Gauge Range
  • Image

Graphic Bezel

This template displays a graphic circular template with optional text wrapped along the bezel of the Infograph watch face. The text can fill nearly 180 degrees of the bezel before becoming truncated. The Infograph watch face is only available on Apple Watch Series 4.

  • Closed Gauge Image

Graphic Rectangular

These templates display full-color images, text, and a gauge in a large rectangular region on the Infograph Modular watch face. Some of the text fields also support multicolor text. The Infograph Modular watch face is only available on Apple Watch Series 4.

  • Standard Body
  • Text Gauge
  • Large Image