Design a watch face with Watch Face Studio
This guide describes the main tools and UI in Watch Face Studio (WFS).

Tools
The WFS interface has a button bar that contains various tools.
- Add Component: Open a dropdown list of components you can add to your watch face.
- Forward: Move the selected component to the front of the canvas.
- Backward: Move the selected component to the back of the canvas.
- Group: Group multiple components together so they can be controlled as one component.
- Ungroup: Ungroup a group of components.
- Mask: Cover all or part of a group of layers based on the shape outline of the bottom-most layer in the group.
- Publish: Open the publication dialog to prepare your watch face files for uploading to the Play Store.
- Run on Device: Scan for and connect to an actual watch device connected to the same WiFi network as your computer, and preview the watch face on it.
Components
Add as many different components as you want to your watch face. You can also use a customized design source for your components. For example, you can display heart rate or step count data with a text component or add a custom image to launch an application.
Watch face canvas
The canvas is the bottom layer of the watch face. You can set its background color.
The canvas is cropped to a circle by default. To use a rectangular canvas, uncheck the Apply circular crop option in the Properties tab. In this case, the watch face shape is determined by the device on which it is installed.


Component types
The following components are available for watch faces.
Text
Text fields hold normal text by default. Normal text is static and does not change. In the Properties tab for your text field, you can change the text field from normal text to data text. Data text changes and is populated based on tags.
For more information, see Tag expressions.
To create text that curves with the watch face, select the Apply Curved-Text option.
Determine the curve of your text by setting the Width (W) and Height (H). Changing W and H automatically changes the dimension of your text component. To determine the position of your text, select a range preset. You can also define a custom range by specifying the Start point and Angular distance. Set the direction of your text to either clockwise (CW) or counter-clockwise (CCW).
Image
Import custom images.
Shape
Add various shapes, including rectangles, rounded rectangles and ellipses.
Progress bar
Add a progress bar to your watch face to track various activities. You can select from a linear or circular progress bar. To determine the position of your progress bar, select a range preset. You can also define a custom range by specifying the Start point and Angular distance. Set the direction of the progress bar to either clockwise or counter-clockwise.
Animation
To create an animation on your watch face using a sequence of images:
- Create an animation sequence with a design program, such as Adobe Flash or Adobe Premiere.
- In WFS, select Add Component > Animation.
- Select the animation sequence images from the file browser, then select Open.
- Edit the animation by changing the order of the images, removing images, or adding images.

- To define when you want your animation to play, configure the trigger value.
To start the animation as soon as the watch face is shown, set the trigger value to WatchFace on. You can also choose from other options, such as Tap, Every Sec, Every Min, and Every Hour. You can also delay the start by a specific number of seconds.

You can also configure various additional animation options:
- Auto replay immediately repeats the animation upon completion until an interruption occurs, such as turning the screen off.
- Repeat delay sets a delay between iterations of the repeated animation.
- Resume Playback determines whether to resume the animation or start from the beginning when play is stopped because of an interruption, such as receiving a notification or a phone call.
- Hide before playing determines whether to hide the animation until play is triggered.
- Hide after finished determines whether to hide the animation when play is completed.
Multimedia
To add an animated image file, such as an AGIF or WebP image:
- In WFS, select Add Component > Multimedia.
- Select the file from your file browser, then select Open.
- To define when you want your animation to play, configure the trigger value.
Keep in mind that the file size, image resolution, and number of frames in the multimedia image can affect device performance and battery consumption. Multimedia images are loaded asynchronously during operation and can be delayed when playing, depending on the capabilities of the user’s watch and various characteristics of the image.
Analog hands
Add analog clock hands for hours, minutes, and seconds.
Open the file browser to select an image file to import for each hand.
Analog clock hands have a “Rotation” property, which has various options:
- Sync with
- Time Zone
- Rotate
- Value
- Movement Effect

To define the time interval or condition for the analog hand movement, configure the Sync With option:
- Hour in Day
- Minute in Hour
- Second in Minute
- Day of Month
- Month of Year
- Day of Week
- Day of Year
- Conditions: Moon Phase Position, Moon Phase Type
When the hand is set to sync with Second in Minute (in other words, it is a second hand), the Sweep movement effect is available.

Digital clock
Add a digital clock displaying the date or time.
When adding a date display, you must also define the date format in a text component with date tags. The default display format for dates is DAY_WEEK_S
, MON_S DAY_1_31_Z
.
When adding a time display, you must also define the time format in a text component with digital clock tags. The default display for digital time is HOUR_1_12_Z:MIN_Z:SEC_Z
.
Component management
Manage your components using the WFS tools. You can add, group, ungroup, and order components on your watch face.
Add components
Add a supported component using the Add component (+
) button.

When you add a component, it is placed in a default position on the canvas. The component is automatically selected so you can easily modify it.
Group or ungroup components
A group is a combination of one or more components. All components can be grouped. Groups can be ungrouped.
Mask or unmask components
When you use a mask group, the shape of the bottom-most layer determines the visible area of the mask group. The layers above it appear only through the shape outline of the bottom layer.
For example, if you place a square image in the bottom layer and an image and an animation in the layers above it, the image and animation appear only through the square outline of the bottom layer.

To create a mask group:
- Select the layers you want to group.
- Select Mask from the button bar or right-click the layers and select Mask.
To unmask (release) the mask group:
- Select the mask group.
- Select Unmask from the button bar or right-click the layers and select Unmask.
Preview area
The preview area is your main working area when designing your watch face.
Add all watch face elements to the canvas in the preview area. On the canvas, drag elements into position and resize, arrange, and rotate them.

Layer list
The layer list displays the components and groups shown in the preview area. Each component has its own layer by default.

Within the layer list, you can:
- Search: Search for a layer by name.
- Show or Hide: Show or hide layers, toggling their visibility in the preview area.
- Theme color: Toggle the theme colors.
- Rename: Rename a layer by double-clicking the layer name.
By right-clicking a layer, you can:
- Lock or Unlock: Lock the layer to its position on the canvas or unlock it so it can be moved.
- Group or Ungroup: Group multiple components together so they can be controlled as one component or ungroups a group of components.
- Mask or Unmask: Cover all or part of the other layers based on the shape outline of the bottom layer or remove the layer from a mask group.
- Swap image: Move the image file from one layer to another. Only shown for images.
- Layer color: Define a color label for the layer to differentiate between layers in the layer list.
Conditional lines
Conditional lines let you show and hide components on a watch face and control the components' behavior. Use conditional lines to change the appearance of your watch face in response to certain conditions, such as time, step count, battery, or event.
When you add a component, the time condition is set by default. To adjust these conditions, click the condition icon on the desired layer. To set your conditional to repeat, right-click the frame area and select Loop.
Keep in mind that layers that are not displayed do not reduce performance or affect battery life.
You can set your watch face to respond to the time, step count, battery status, or an event, as described in the following sections.
Time
Your watch face can change dynamically based on time intervals. For example, your watch face can be bright during the day then gradually darken after a set time. You can set the time to be measured in hours, minutes, or seconds.
To add a time condition:
- Create the layers to be displayed conditionally.
- In the timeline, for each layer, set the time periods to control when each layer is displayed. Click and drag the start and end handles to define a time range. To create another time range for the same layer, double-click and drag from the start time to the end time.
- To preview your changes, use the Run panel and the time control slider.
To display different watch faces for a 12-hour setting and a 24-hour setting based on the chosen setting on the user’s phone:
- Add two digital clock components, the first component for the 12-hour version and the second for the 24-hour version.
- Place them in the same position.
- Add 12-hour and 24-hour conditions to the components' conditional lines.
- Set time periods to show the first digital clock component for the 12-hour layer in the 12-hour format and to show the other layer in the 24-hour format.
Time control
The time control slider lets you see your watch face in action. Use this to preview how your watch face changes throughout the day. Drag the slider to specific times or view your watch face animations by using the play and fast-forward buttons.

Step count
You can design your watch face to change dynamically according to the user's step count. For example, you can create a watch face that changes based on the percentage of the daily step goal that has been achieved.
Battery
You can design your watch face to change dynamically according to the watch's available percentage of battery life.
Event
You can design your watch face to change dynamically according to the device state, such as low battery or unread notifications. To do so, select the desired event and the image or animation you want to display during that event.

Properties tab
Each component has a range of modifiable properties. For example, you can change the color of the numbers on a digital clock or choose whether the watch hands measure hours, minutes, or seconds.

Action options
The Action options within the Properties tab enable interaction with your watch face. For example, you can let the user tap a component to change images or open other applications.

Color
Apply a specific color to your component or save a theme color for the watch face. For complications, the initial color theme is grayscale.
Image appearance
Modify an image's appearance using the following controls:
- Hue controls the tone of the color.
- Saturate makes the image color more or less vivid.
- Lightness causes the image colors to be lighter or darker.
Text appearance
Use the Text appearance options to define the text alignment and font style. To decorate the text, in the project settings, select Add Bitmap Font. If you want to use the default font size among the bitmap fonts added to the project, select Apply Default Font Size.

Style tab
Use the Style tab to modify the style of the selected layer. You can define image styles and theme color palettes that the user can choose from to customize their watch.

Image style
Styles can be added for image-based layers, such as image, multimedia image, index, and hand component layers. The watch face supports up to 10 image styles.
To add an image style to the selected layer, in the Style section, add a file of the same type as the existing image in the layer.
Theme color palette
Theme color palettes can be defined in the Style tab. Each palette can have up to 3 colors. The watch face supports up to 30 theme colors.
You can assign the theme color for the selected layer in different ways:
- From the Layer list, cycle through the 3 theme colors with the “Apply Theme Color” icon.

- From the Properties tab, select “Apply Theme Color” and define which of the 3 colors to apply from the theme color palette.

Customization Editor
The Customization Editor in WFS enables you to refine, organize, name, and preview the styles you have defined for the watch:
- You can combine components so that they change styles at the same time and define the order in which the styles appear on the device.

- You can select the text ID for the style name to be displayed on the watch. You can also create a new text ID and select it.


- You can test your style combinations, style display order, and style name in the Customization Editor preview.
Run
To preview how your watch face looks along a timeline, use the Run panel in WFS. You can select a device shape and adjust the time, date, device battery level, user step count, user heart rate, and gyro values to test how your watch face looks in different circumstances. You can also adjust any other styles that can be set in the Customization Editor, including the number of unread notifications, tag expressions, or conditional lines. The Run preview can be set to show the active or always-on (ambient) mode.
When previewing the always-on mode, WFS displays the current on-pixel ratio and provides an analysis tool that enables you to analyze each screen along a timeline.
To open the Run preview in a separate window, select the “Preview Watch Face” button.
For information on testing your watch face on an actual device, see Test your watch face.