Watch Face Format version <button value="5" default="">Version 5</button> <button value="4">Version 4</button> <button value="3">Version 3</button> <button value="2">Version 2</button> <button value="1">Version 1</button>

*** ** * ** ***

Represents a predefined or user-defined key-value pair.

Introduced in Wear OS 4.

## Syntax

```xml
<Metadata key="string" value="string" />
```

## Attributes

Each `Metadata` element contains 2 attributes, `key` and `value`. User-defined
metadata elements must use strings for both `key` and `value`.

Predefined values for `key` include the following:

`PREVIEW_TIME`

:   Sets the time that appears in the watch face preview. The value must be in
    HH:MM:SS format; for example, `22:10:00` represents 10:10 PM.

    If this value is invalid or unspecified, the watch face uses the system's
    default time.

`CLOCK_TYPE`

:   Specifies the primary watch face type, either `DIGITAL` or `ANALOG`. Even if
    your watch face supports both types, you must specify a primary type to appear
    in the watch face preview.

    If this value is invalid or unspecified, the system uses a default value of
    `ANALOG`.

`STEP_GOAL`

:   Sets the daily "number of steps" goal that appears in the watch face preview.
    This value must be a positive integer.

    If this value is invalid or unspecified, the watch face uses the system's
    default daily step goal.

## Recommended for you

- Note: link text is displayed when JavaScript is off
- [Create shortcuts.xml](https://developer.android.com/develop/devices/assistant/action-schema)
- [State and Jetpack Compose](https://developer.android.com/develop/ui/compose/state)
- [Advanced State and Side Effects in Jetpack Compose](https://developer.android.com/codelabs/jetpack-compose-advanced-state-side-effects)