Watch Face Studio (WFS) helps you to create and customize watch face complications that display additional information on a watch face.
Complications display data from a data source. This lets you display additional information on your watch face without needing to use extra code.
Adding complications
To create a complication, select a complication slot from the Add Component button in WFS. You can allow users to customize the displayed data for each slot, as long as the data provider supports the data that the complication displays.
Figure 1. Complication slots
A complication slot consists of complication components and a slot bound. The components implement the layout, and the slot bound a cut-out through which the complication component appears, in a similar way to masking.
The following table lists the available complication slots, their slot bound shapes, and the supported layout types for the shapes.
Complication slot
Slot bound shape
Supported complication types
Circle
Circle
Short text
Range value
Small image
Icon
Line
Rectangle
Short text
Small box
Rectangle
Short text
Range value
Small image
Icon
Large box
Rectangle
Long text
Range value
Small image
Table 1. Complication slots and their slot bound shapes
Figure 2. Slot bound shapes
Note:Watch Face Studio version 1.7 or later supports the Ranged Value complication, which additionally provides a color ramp selection field. If the Range Value (Circle) is used, it can display data for various information types such as goal progress, weighted elements, and ranged values.
Configuring complications
You can configure various settings for a complication:
Editable or fixeded
To allow the user to customize the complication data and provider, select Editable. To limit the complication data and provider to the values you define, select Fixed.
Figure 3. Editable complication setting
Supported types
Select the layout types you want to show in the Default Provider list for your design. All layout types are selected by default.
If you select multiple complication layout types, you can reorder the list by priority. In the following figure, Short text is at the highest priority, so if an application provides ranged value and short text data, the complication slot shows the short text.
Figure 4. Example of supported types and default provider for a circle complication slot
Default provider
The default provider defines which data is to be displayed in the complication slot when the watch face is installed. It uses the selected layout type.
Managing complication layouts
When you add a complication slot to your project, it contains 1 or more predefined layouts. The predefined layouts are optimized for the slot type, but you can modify them to suit your design needs. The supported layout types you define for the complication slot affect the available layouts.
Figure 5. Predefined layouts for each layout type
Testing complication designs
To check the size and placement of the data elements in your complication design, you can define test content, such as text or images, for each component in the complication. This test content is dummy content that is not shown on the actual watch face when you publish it.
Figure 6. Test content for complication design
Manage Your Cookies
We use cookies to improve your experience on our website and to show you relevant
advertising. Manage you settings for our cookies below.
Essential Cookies
These cookies are essential as they enable you to move around the website. This
category cannot be disabled.
Company
Domain
Samsung Electronics
.samsungdeveloperconference.com
Analytical/Performance Cookies
These cookies collect information about how you use our website. for example which
pages you visit most often. All information these cookies collect is used to improve
how the website works.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Functionality Cookies
These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and
tailor the website to provide enhanced features and content for you.
Company
Domain
LinkedIn
.ads.linkedin.com, .linkedin.com
Advertising Cookies
These cookies gather information about your browser habits. They remember that
you've visited our website and share this information with other organizations such
as advertisers.
Company
Domain
LinkedIn
.linkedin.com
Meta (formerly Facebook)
.samsungdeveloperconference.com
Google Inc.
.samsungdeveloperconference.com
Preferences Submitted
You have successfully updated your cookie preferences.