Stay organized with collections
Save and categorize content based on your preferences.
Allows watch face creators to define modified appearances, by changing the
values of specific color and geometric properties, when the Wear OS device is in
different display modes. As of Wear OS 4, the only supported mode is ambient
mode.
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,["# Variant\n\nWatch Face Format version Version 4 Version 3 Version 2 Version 1\n\n*** ** * ** ***\n\nAllows watch face creators to define modified appearances, by changing the\nvalues of specific color and geometric properties, when the Wear OS device is in\ndifferent display modes. As of Wear OS 4, the only supported mode is ambient\nmode.\n\nIntroduced in Wear OS 4.\n\nSyntax\n------\n\n```xml\n\u003cVariant mode=\"AMBIENT\" target=\"attribute-name\" value=\"valid-value\" /\u003e\n```\n\nAttributes\n----------\n\nThe `Variant` element has the following required attributes:\n\n`mode`\n\n: The mode that the Wear OS device must be in for the variant to take effect.\n\n As of Wear OS 4, this value must be `AMBIENT`.\n\n`target`\n\n: The attribute whose value should change when the specified Wear OS device mode\n takes effect. This must be a [transformable](/training/wearables/wff/common/transform/transform#transformable) attribute.\n\n`value`\n\n: The value that the attribute should have when the specified Wear OS device\n mode takes effect.\n\n\n Recommended for you\n -------------------\n\n - Note: link text is displayed when JavaScript is off\n - [Features and APIs Overview](/about/versions/11/features)\n - [Transform](/training/wearables/wff/common/transform/transform)\n - [Layouts and binding expressions](/topic/libraries/data-binding/expressions)"]]
