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>

*** ** * ** ***

A Complication Slot is an area of the watch face that a Complication can be
added by the user. Complication Slots contain [Complication](https://developer.android.com/training/wearables/tiles/complications) elements, which
define how the Complication is rendered for different Complication Types and in
different watch face modes.

> [!NOTE]
> **Note:** A watch face can have at most eight instances of `ComplicationSlot`, total.

Introduced in Wear OS 4.

## Syntax

```xml
<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="SHORT_TEXT | LONG_TEXT | MONOCHROMATIC_IMAGE | SMALL_IMAGE | PHOTO_IMAGE | RANGED_VALUE | EMPTY"
             isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />
```

## Attributes

The `ComplicationSlot` has the following attributes:

### Required attributes

The following attributes are required:

`x`, `y`, `width`, `height`
:   A collection of integers that specify the element's size and position.

`slotId`
:   A unique numeric identifier for the slot.

`supportedTypes`
:   The types of complication that can be displayed in the slot. See [Complication Types](https://developer.android.com/training/wearables/tiles/complications) for details.
    Multiple complication types can be supported by separating them with a space (for
    example, `SHORT_TEXT RANGED_VALUE`).

### Optional attributes

The following attributes are optional:

`pivotX`, `pivotY`
:   A two-dimensional pivot point about which the element rotates. Both values
    are floating-point numbers that are scaled to fit in the range $ \[0, 1\] $.

`angle`
:   A number of degrees, clockwise, that the element should be rotated about its
    pivot point.

`alpha`
:   Set the level of transparency that this element should have. A value of `0`
    indicates that the element should be completely transparent. A value of `255`
    indicates that the element should be completely opaque.

`scaleX`
:   The horizontal scaling factor to apply to this element.

`scaleY`
:   The vertical scaling factor to apply to this element.

`tintColor`
:   Apply a tint color filter to the element. You must specify the color using
    either the ARGB format (`#ff000000` = opaque black) or the RGB format
    (`#000000` = black).

`displayName`
:   A resource ID corresponding to a localized name for the complication slot,
    which is displayed in the watch face editor.

`isCustomizable`
:   Determines whether a user can change the provider for this slot in the watch
    face editor. Defaults to `TRUE`.

[`blendMode`](https://developer.android.com/training/wearables/wff/effects#blend-mode)
:   Sets the [`blendMode`](https://developer.android.com/training/wearables/wff/effects#blend-mode) for drawing this `ComplicationSlot` (this element is
    treated as the *src*).

## Inner elements

The `ComplicationSlot` element must contain exactly one [Bounding Area](https://developer.android.com/training/wearables/wff/complication/bounding)
element.

A `ComplicationSlot` element must contain at least a [Complication](https://developer.android.com/training/wearables/wff/complication/complication) element
per supported Complication Type. A `ComplicationSlot` element can optionally
contain more [Complication](https://developer.android.com/training/wearables/wff/complication/complication) elements to support changing appearance with
[Variant](https://developer.android.com/training/wearables/wff/common/variant/variant) elements.

The `ComplicationSlot` element can also contain the following inner elements:

- [`DefaultProviderPolicy`](https://developer.android.com/training/wearables/wff/complication/default-provider-policy)
- [`Variant`](https://developer.android.com/training/wearables/wff/common/variant/variant)
- [`ScreenReader`](https://developer.android.com/training/wearables/wff/common/screen-reader)

## Recommended for you

- Note: link text is displayed when JavaScript is off
- [PartImage](https://developer.android.com/training/wearables/wff/v2/group/part/image/part-image)
- [PartText](https://developer.android.com/training/wearables/wff/v2/group/part/text/part-text)