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

# list

Creates a generic container.

## Overview

The `list` element is a generic element that contains nearly all other elements in
the templates that use it. Here’s an example of a `list` inside of a `paradeTemplate`.
The `list` element contains the information for the page.

```xml
<paradeTemplate>
    <list>
        <header>
            <title>Movie Genres</title>
        </header>
        <section>
            <listItemLockup>
                <title>Action</title>
            </listItemLockup>
            <listItemLockup>
                <title>Comedy</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>
```

### Subelements for list

- [header](/documentation/TVML/header)
- [relatedContent](/documentation/TVML/relatedcontent)
- [section](/documentation/TVML/section)
- [tumblerBar](/documentation/TVML/tumblerbar)

### Elements that Use list

- [catalogTemplate](/documentation/TVML/catalogtemplate)
- [compilationTemplate](/documentation/TVML/compilationtemplate)
- [listTemplate](/documentation/TVML/listtemplate)
- [paradeTemplate](/documentation/TVML/paradetemplate)
- [searchTemplate](/documentation/TVML/searchtemplate)

## Topics

### Valid TVML Styles

[margin](/documentation/TVML/margin)

Specifies the spacing around an element.

[padding](/documentation/TVML/padding)

Specifies the padding between the border and contents of an element.

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

Aligns an element horizontally inside its parent.

[tv-interitem-spacing](/documentation/TVML/tv-interitem-spacing)

Specifies the spacing between child elements.

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

Specifies how wide an element is.

### Valid TVML Attributes

[binding](/documentation/TVML/binding)

Associates information in a data item with an element.

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