A template for displaying an image encircled by a configurable progress ring.


class CLKComplicationTemplateExtraLargeRingImage : CLKComplicationTemplate


This template belongs to the CLKComplicationFamily.extraLarge family.

Figure 1 shows the layout of the data and where a template of this type might appear on the clock face.

Figure 1

Layout of an extra large ring image template

Diagram showing the layout of an image inside a progress ring.

Table 1 lists the dimensions of the image you use in this template. All dimensions are in pixels. All images must be specified as @2x images for display on Apple Watch, so the point-based dimensions are half the listed size.

Table 1

Image dimensions

Apple Watch Size



38 mm

126 pixels

126 pixels

40 mm

133 pixels

133 pixels

42 mm

133 pixels

133 pixels

44 mm

146 pixels

146 pixels

Instead of providing multiple images with different resolutions, you can provide a single, scaleable PDF asset. For more information, see Manage Assets.


Setting the Complication Data

var fillFraction: Float

The fraction of the ring to fill.

var imageProvider: CLKImageProvider

The image to display in the complication.

var ringStyle: CLKComplicationRingStyle

The style of the progress ring.


Conforms To

See Also

Image Templates

class CLKComplicationTemplateExtraLargeSimpleImage

A template for displaying an image.

class CLKComplicationTemplateExtraLargeStackImage

A template for displaying a single image with a short line of text below it.