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

# paradeTemplate

Displays a groups of items along one side of a page and scrolling images on the other
side.

## Overview

Use the `paradeTemplate` element to display a list of automatically scrolling, static
images on the left that are associated with a selected image category on the right.
For example, a user selects Action movies, and the associated images automatically
start scrolling. The following figure shows the basic layout for a `paradeTemplate`
page. The theme for the parade template defaults to the system preference.

![Layout diagram showing an image deck area on the left side, and a header area above a section area on the right.](images/com.apple.TVML/paradetemplate-1.png)

### Main Elements

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

```xml
<paradeTemplate>
   <list>
      <header>
         <title>Title</title>
      </header>
      <section>
         <listItemLockup>
            <title>Title 1</title>
         </listItemLockup>
         <listItemLockup>
            <title>Title 2</title>
         </listItemLockup>
      </section>
      <relatedContent>
         <imgDeck>
            <img src="" />
            <img src="" />
         </imgDeck>
      </relatedContent
   </list>
</paradeTemplate>
```

#### Element Descriptions

- [header](/documentation/TVML/header): Title information for the list of image categories on the right
  side of the screen.
- [img](/documentation/TVML/img): A single image that scrolls across the left side of the screen.
- [imgDeck](/documentation/TVML/imgdeck): A group of images on the left side of the screen that scroll
  right-to-left.
- [list](/documentation/TVML/list): Element containing all the elements that are displayed.
- [listItemLockup](/documentation/TVML/listitemlockup): Information about an individual item in the list of
  image categories.
- [relatedContent](/documentation/TVML/relatedcontent): Element containing the image deck that is associated
  with a particular item in the list.
- [title](/documentation/TVML/title): The text used to provide a description for its containing element.

### Example

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

```xml
<document>
    <paradeTemplate>
        <list>
            <header>
                <title>Movie Genres</title>
            </header>
            <section>
                <listItemLockup>
                    <title>Action</title>
                </listItemLockup>
                <listItemLockup>
                    <title>Comedy</title>
                </listItemLockup>
                <listItemLockup>
                    <title>Horror</title>
                </listItemLockup>
                <listItemLockup>
                    <title>Kids</title>
                </listItemLockup>
                <listItemLockup>
                    <title>Drama</title>
                </listItemLockup>
            </section>
            <relatedContent>
                <imgDeck>
                    <img src="path to images on your server/Car_Movie_250x375.png "/>
                    <img src="path to images on your server/Car_Movie_250x375_A.png "/>
                    <img src="path to images on your server/Car_Movie_250x375_B.png "/>
                    <img src="path to images on your server/Car_Movie_250x375_C.png "/>
                </imgDeck>
            </relatedContent>
        </list>
    </paradeTemplate>
</document>
```

The following figure shows the output for the above example:

![Screenshot showing movie genres on the right. A collage of images relating to the selected movie genre is on the left.](images/com.apple.TVML/paradetemplate-2@2x.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)