Skip to content

Complications

What complications are, how one design shows data from many sources, and how to make one step by step.

On a watch, a complication is anything a watch face shows besides the time: the date, the weather, your next appointment, the battery level. The word comes from watchmaking, where every extra feature made the mechanism more complicated.

On Wear OS, complications work in a special way, and that’s what makes them powerful: the watch face decides how the data looks, and the wearer decides which data it shows. Apps on the watch offer data (the weather app offers the temperature, the calendar your next event), and the wearer picks one of them for each complication, on the watch itself.

So a complication you make in Pujie is not a “weather complication” or a “battery complication”. It’s a design for a kind of data: a style that says “a short line of text goes here, with an icon above it”. Whatever source the wearer picks, the temperature, the step count or the sunrise time, your design shows it.

That’s the one idea to hold on to. It feels unusual at first, but it means one design works with every app on the watch, including apps that don’t exist yet. Here one ring design shows the battery, the step count and a calendar countdown, whichever the wearer picks:

Sources offer their data in a few fixed shapes, called types. A step counter might offer a number on a scale (ranged value) and a short text; a music app a small image. Your complication says which types it can show:

TypeWhat it holdsAlwaysSometimes
Short textA short line of text: steps, a temperature, a labelShort textIcon, short title
Long textA longer line: a calendar event, a descriptionLong textLong title, icon, small image
Ranged valueA value on a scale, to draw as a gauge: battery, steps toward a goalValue, minimum, maximumIcon, short text, short title
IconA single-color icon, which you can tintIcon
Small imageA small picture: album art, an app’s iconSmall image, as a photo or as an icon
Large imageA full-size picture, for a backgroundLarge image

The “sometimes” fields are what makes designing interesting: a source may send them or not. A battery source gives a value and maybe an icon; another ranged value source might add a short text. A good design looks right either way.

A complication can support several types. The more it supports, the more sources the wearer can choose from. The order matters: when a source offers more than one of your types, the watch uses the one highest in your list, so put the type you designed most carefully, usually the richest, first.

A few complications from the Library and from Pujie users, each showing a value of 65 out of 100 with a battery icon. Tap one from the Library to open it there.

Tap the add button above the element list, pick Complication, then New item. The first thing you see is the Supported data types sheet:

The supported data types sheet, with short text and ranged value under Supported and the other types under AvailableThe supported data types sheet, with short text and ranged value under Supported and the other types under Available

Drag the types your design will show from Available up into Supported, in order of priority, and tap Create. Tap the arrow on a card to see which fields that type always has and which ones it may have; the stars rate how much a type can show, from one for an icon to five for a ranged value. Not sure? Start with just Short text: it’s the type most sources offer. See Supported data types.

You can also start from a complication someone else made: pick From the watch face library instead of New item.

The new complication opens in the watch element designer, with starter layers already in place: one for each field of the types you picked, such as the text, the title or the icon. These layers are bound to their field: on the watch they show the source’s data. They’re marked Locked in the layer list, so a swipe can’t remove them by accident.

Now style them the way you like: fonts, colors, sizes, positions, and anything you want around them, like a ring, a background or a gauge needle. Everything you can do in the watch element designer works here.

  • Text fields are tags in a text layer: [cstext] is the short text, [cstitle] the short title, [cltext] and [cltitle] the long ones. You can add them to any text layer, with other text around them.
  • Images and icons are image layers bound to a field. To bind one, pick the field as the layer’s image in Image source.
  • Values drive automation: [cvalue], [cmin] and [cmax], and [cnormval], the value as a fraction from 0 to 1, which is the easiest to use. Turn a needle with it, or let an arc grow with it.
  • Optional fields may be empty. A starter layer for an optional field says so in its name. If your design doesn’t need one, hide the layer instead of deleting it.

In the Value complication, the needle’s rotation and the arc’s angle both follow the value: the needle turns ([cvalue]-[cmin])/([cmax]-[cmin])*245 degrees, the share of the range times the 245 degrees of the dial, and the arc’s sweep uses the same formula. Bars shows each bar only above its own share, with visibility [cnormval]>(2/6) for the third one. Here’s Value from 0 to 100:

At the top of the watch element designer, Complication data opens Pick your complication data: the data sources you can preview your design with.

The pick your complication data sheet for the Value complication: the Test data sources, each previewed in the gauge, such as value with text and value with icon and textThe pick your complication data sheet for the Value complication: the Test data sources, each previewed in the gauge, such as value with text and value with icon and text

The first sources are Test data: made-up values that show each combination of fields, like text only, text with an icon, or text with a title. Go through all of them: your design should look good with each one. Below them are real sources, such as the date, the battery, the heart rate or the step count.

When something should only show for some data, use automation to hide it. Each type has a marker that is true when that type is showing, such as [cisshorttext] or [cisrangedvalue], and each field has one that is true when the source sent it, such as [chicon] for the icon. When you support several types, the starter layers that belong to only one of them already hide themselves this way.

A complication can be tapped on the watch. By default the tap area is a rounded box the size of the complication. To give it your design’s shape, choose Set as outline in the menu of a shape or arc layer: an ellipse gives a round tap area, an arc an arc-shaped one.

Back in the watch face designer, place the complication with its position and size. On its row, the complication data button picks the source it starts with: the data the watch shows until the wearer picks something else. Pick a real source here, not a test one.

The wearer chooses the data on the watch: long-press the watch face, tap the customize or edit button under it, and tap the complication. The watch lists every source that offers one of your types. Each complication is named after its element, so give your complications clear names, like “Top left” or “Small gauge”.

Tapping a complication on the watch is up to the source; usually it opens the app the data comes from.

  • At most 8 complications on a watch face, the interactive and the always-on face together.
  • Short or long? Most sources offer short text. Choose long text only when your design has room for a sentence.
  • Complications show on the always-on face too. Add one to the ambient elements for it, and keep it calm: no bright backgrounds.
  • Quick data without a choice: when the data should always be the same (always the battery, for instance), a dynamic element is simpler: you put the data in yourself, and the wearer doesn’t need to pick anything.