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

# section

Combines elements and acts as a single element.

## Overview

The `section` element groups elements together so they can be treated as a single
element for layout purposes. Here’s an example that uses a section to hold two movie
`lockup` elements and places them in a `shelf` element.

```xml
<shelf>
    <header>
        <title>Viewers Also Watched</title>
    </header>
    <section>
        <lockup>
            <img src="path to images on your server/Car_Movie_250x375_A.png" width="150" height="226" />
            <title>Turn</title>
        </lockup>
        <lockup>
            <img src="path to images on your server/Car_Movie_250x375_B.png" width="150" height="226" />
            <title>Road</title>
        </lockup>
    </section>
</shelf>
```

### Subelements of section

- [header](/documentation/TVML/header)
- [listItemLockup](/documentation/TVML/listitemlockup)
- [lockup](/documentation/TVML/lockup)
- [menuItem](/documentation/TVML/menuitem)

### Elements that Use section

- [carousel](/documentation/TVML/carousel)
- [grid](/documentation/TVML/grid)
- [list](/documentation/TVML/list)
- [menuBar](/documentation/TVML/menubar)
- [oneupTemplate](/documentation/TVML/oneuptemplate)
- [shelf](/documentation/TVML/shelf)

## Topics

### Valid TVML Styles

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

Specifies the spacing between child elements.

### Valid TVML Attributes

[binding](/documentation/TVML/binding)

Associates information in a data item with an element.

[indexTitles](/documentation/TVML/indextitles)

Specifies index bar titles for a section element.

[itemID](/documentation/TVML/itemid)

Mark elements for reuse during DOM updates.

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