Stay organized with collections
Save and categorize content based on your preferences.
Represents a predefined or user-defined key-value pair.
Introduced in Wear OS 4.
Syntax
<Metadatakey="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
Content and code samples on this page are subject to the licenses described in the Content License. Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
Last updated 2025-05-20 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-20 UTC."],[],[],null,["# Metadata\n\nWatch Face Format version Version 4 Version 3 Version 2 Version 1\n\n*** ** * ** ***\n\nRepresents a predefined or user-defined key-value pair.\n\nIntroduced in Wear OS 4.\n\nSyntax\n------\n\n```xml\n\u003cMetadata key=\"string\" value=\"string\" /\u003e\n```\n\nAttributes\n----------\n\nEach `Metadata` element contains 2 attributes, `key` and `value`. User-defined\nmetadata elements must use strings for both `key` and `value`.\n\nPredefined values for `key` include the following:\n\n`PREVIEW_TIME`\n\n: Sets the time that appears in the watch face preview. The value must be in\n HH:MM:SS format; for example, `22:10:00` represents 10:10 PM.\n\n If this value is invalid or unspecified, the watch face uses the system's\n default time.\n\n`CLOCK_TYPE`\n\n: Specifies the primary watch face type, either `DIGITAL` or `ANALOG`. Even if\n your watch face supports both types, you must specify a primary type to appear\n in the watch face preview.\n\n If this value is invalid or unspecified, the system uses a default value of\n `ANALOG`.\n\n`STEP_GOAL`\n\n: Sets the daily \"number of steps\" goal that appears in the watch face preview.\n This value must be a positive integer.\n\n If this value is invalid or unspecified, the watch face uses the system's\n default daily step goal.\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Create shortcuts.xml](/develop/devices/assistant/action-schema)\n- [State and Jetpack Compose](/develop/ui/compose/state)\n- [Advanced State and Side Effects in Jetpack Compose](/codelabs/jetpack-compose-advanced-state-side-effects)"]]