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

# Layout Elements

Organize and display multiple elements in a structured layout.

## Overview

Each compound element organizes its contained elements differently. For example,
a `shelf` element displays its information horizontally, while a `grid` element can
display information horizontally and vertically.

## Topics

### Container Elements

[carousel](/documentation/TVML/carousel)

Arranges images in a row.

[grid](/documentation/TVML/grid)

Arranges elements in a grid pattern.

[imgDeck](/documentation/TVML/imgdeck)

Contains several images to be displayed at a later time.

[infoTable](/documentation/TVML/infotable)

Displays contained element information in a vertical format, with each successive
element directly below the previous element.

[organizer](/documentation/TVML/organizer)

Creates a generic element with its contained elements arranged through TVML styles.

[row](/documentation/TVML/row)

Displays elements horizontally.

[section](/documentation/TVML/section)

Combines elements and acts as a single element.

[stack](/documentation/TVML/stack)

Groups and lays out elements vertically.

[shelf](/documentation/TVML/shelf)

Displays elements horizontally and adds the ability to scroll to offscreen elements.

### Bar Elements

[menuBar](/documentation/TVML/menubar)

Displays menu items along the top of the screen.

[menuItem](/documentation/TVML/menuitem)

Displays a label for an item.

[nowPlayingMenuItem](/documentation/TVML/nowplayingmenuitem)

Displays information about currently playing audio.

[segmentBar](/documentation/TVML/segmentbar)

Displays a list of segment bar items.

[segmentBarHeader](/documentation/TVML/segmentbarheader)

Displays information above a segment bar.

[segmentBarItem](/documentation/TVML/segmentbaritem)

Provides titles inside of a segment bar.

[tumblerBar](/documentation/TVML/tumblerbar)

Displays a list of `tumblerItem` elements.

[tumblerItem](/documentation/TVML/tumbleritem)

Contains title information for a tumbler header.

### List Elements

[collectionList](/documentation/TVML/collectionlist)

Contains other layout elements.

[infoList](/documentation/TVML/infolist)

Displays `info` element information in a vertical format.

[list](/documentation/TVML/list)

Creates a generic container.


---

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)