<!--
{
  "documentType" : "article",
  "framework" : "TVML",
  "identifier" : "/documentation/TVML/decorationlabel",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "decorationLabel"
}
-->

# decorationLabel

Displays text that describes a displayed element.

## Overview

This element is commonly used to provide additional information for a media item
or group of media items; for example, the running time for a movie. Here’s an example
where the decoration label displays the number of items contained in a `listItemLockup`
element.

```xml
<listItemLockup>
    <title>Comedies</title>
    <decorationLabel>4</decorationLabel>
    <relatedContent>
        <grid>
            <section>
                <lockup>
                    <img src="path to images on your server/Car_Movie_250x375_B.png" width="250" height="376" />
                    <title>Movie 2</title>
                </lockup>
                <lockup>
                    <img src="path to images on your server/Car_Movie_250x375_A.png" width="250" height="376" />
                    <title>Movie 1</title>
                </lockup>
                <lockup>
                    <img src="path to images on your server/Car_Movie_250x375.png" width="250" height="376" />
                    <title>Movie 4</title>
                </lockup>
                <lockup>
                    <img src="path to images on your server/Car_Movie_250x375_C.png" width="250" height="376" />
                    <title>Movie 3</title>
                </lockup>
            </section>
        </grid>
    </relatedContent>
</listItemLockup>
```

### Contained In

- [listItemLockup](/documentation/TVML/listitemlockup)

## Topics

### Valid TVML Styles

[color](/documentation/TVML/color)

Changes the color of an element.

[font-family](/documentation/TVML/font-family)

Specifies the font used for the text in an element.

[font-size](/documentation/TVML/font-size)

Specifies the font size for the text in an element.

[font-weight](/documentation/TVML/font-weight)

Specifies the font weight for the text in an element.

[margin](/documentation/TVML/margin)

Specifies the spacing around an element.

[max-height](/documentation/TVML/element-shaping-max-height)

Specifies the maximum height for an element.

[max-width](/documentation/TVML/element-shaping-max-width)

Specifies the maximum width for an element.

[min-height](/documentation/TVML/element-shaping-min-height)

Specifies the minimum height for an element.

[min-width](/documentation/TVML/element-shaping-min-width)

Specifies the minimum width for an element.

[text-align](/documentation/TVML/text-align)

Aligns text horizontally in an element.

[text-shadow](/documentation/TVML/text-shadow)

Adds a shadow effect to displayed text.

[tv-highlight-color](/documentation/TVML/tv-highlight-color)

Changes an element’s color when it comes into focus.

[tv-text-style](/documentation/TVML/tv-text-style)

Sets a predefined size and style for text.

### Valid TVML Attributes

[accessibilityText](/documentation/TVML/accessibilitytext)

Adds hidden text to an element that is used when VoiceOver is enabled.

[binding](/documentation/TVML/binding)

Associates information in a data item with an element.

[height](/documentation/TVML/image-attributes-height)

Specifies the maximum height for an image.

[opaque](/documentation/TVML/opaque)

Indicates whether an image has a transparent background.

[prototype](/documentation/TVML/prototype)

Associates a data item type with an element.

[theme](/documentation/TVML/theme)

Sets the color scheme for an element.

[width](/documentation/TVML/image-attributes-width)

Specifies the maximum width for an image element.



---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)