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

# descriptiveAlertTemplate

Displays large amounts of important information to the user.

## Overview

Use the `descriptiveAlertTemplate` element to display a significant amount of important
information, such as a Terms of Service page. A title is displayed at the top of
the screen with a large text area directly below it. An area containing buttons is
located along the bottom of the screen. The following figure shows the basic layout
for a `descriptiveAlertTemplate` page. The theme for the descriptive alert template
defaults to the system preference.

![Layout diagram showing title area at the top, a description area directly below it, and a row of buttons at the bottom.](images/com.apple.TVML/descriptivealerttemplate-1.png)

### Main Elements

The following listing shows the main elements of the `descriptiveAlertTemplate` in
TVML format.

```xml
<descriptiveAlertTemplate>
   <background>
      …
   </background>
   <title>Title</title>
   <img />
   <description>Description</description>
   <row>
      <button>
         …
      </button>
   </row>
</descriptiveAlertTemplate>
```

#### Element Descriptions

- [background](/documentation/TVML/background): Background elements, such as audio.
- [button](/documentation/TVML/button): A button for the alert. A button typically lets the user dismiss
  the alert or bring up a new template page.
- [description](/documentation/TVML/description): The main text for the alert.
- [img](/documentation/TVML/img): An image associated with the alert box.
- [row](/documentation/TVML/row): A row of buttons.
- [title](/documentation/TVML/title): The title for the descriptive alert page.

### Example

The following listing shows the TVML for a `descriptiveAlertTemplate` example.

```xml
<document>
   <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>
         <button>
            <text>Accept</text>
         </button>
         <button>
            <text>Decline</text>
         </button>
      </row>
   </descriptiveAlertTemplate>
</document>
```

The following figure shows the output for the above example:

![Screenshot showing a Terms of Service example page. Two buttons let the user accept or decline the Terms of Service.](images/com.apple.TVML/descriptivealerttemplate-2.png)

## Topics

### Valid TVML Attributes

[autoHighlight](/documentation/TVML/autohighlight)

Specifies that the element should initially be in focus.

[binding](/documentation/TVML/binding)

Associates information in a data item with an element.

[layoutDirection](/documentation/TVML/layoutdirection)

Specifies the direction in which text is displayed.

[prototype](/documentation/TVML/prototype)

Associates a data item type with an element.

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