Terms of Service

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

# description

Displays multiple lines of text.

## Overview

The `description` element contains text used to describe a displayed element. This
element is often used to provide descriptions that are significantly longer than
those contained in the `text` element. Here’s an example that uses the `descriptiveAlertTemplate`
to list an app’s Terms of Service.

```xml
<descriptiveAlertTemplate>
   <title>Terms of Service</title>
   <description>Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum</description>
   <row>
      ...
   </row>
</descriptiveAlertTemplate>
```

### Contained In

- [alertTemplate](/documentation/TVML/alerttemplate)
- [banner](/documentation/TVML/banner)
- [descriptiveAlertTemplate](/documentation/TVML/descriptivealerttemplate)
- [header](/documentation/TVML/header)
- [lockup](/documentation/TVML/lockup)
- [overlay](/documentation/TVML/overlay)
- [relatedContent](/documentation/TVML/relatedcontent)
- [reviewCard](/documentation/TVML/reviewcard)
- [section](/documentation/TVML/section)
- [stackTemplate](/documentation/TVML/stacktemplate)

## Topics

### Valid TVML Styles

[background-color](/documentation/TVML/background-color)

Changes the background color of an element.

[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.

[padding](/documentation/TVML/padding)

Specifies the padding between the border and contents of 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-minimum-scale-factor](/documentation/TVML/tv-minimum-scale-factor)

Sets the minimum size for text.

[tv-text-max-lines](/documentation/TVML/tv-text-max-lines)

Specifies the maximum number of lines of text in an element.

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

Sets a predefined size and style for text.

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

Specifies how wide an element is.

### 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.

[handlesOverflow](/documentation/TVML/handlesoverflow)

Adds the “MORE” label to a description.

[prototype](/documentation/TVML/prototype)

Associates a data item type with an element.

[showsScrollIndicator](/documentation/TVML/showsscrollindicator)

Shows a scroll indicator along the side of an element appropriate for the user’s
specified language.

[theme](/documentation/TVML/theme)

Sets the color scheme for an 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)