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

# carousel

Arranges images in a row.

## Overview

The `carousel` element displays images in a row that the user can navigate by swiping
left and right on the remote. Here’s an example that creates a carousel containing
three movie scenes that the user can navigate between.

```xml
<carousel>
    <section>
        <lockup>
            <img src="path to images on your server/Car_Movie_453x255_C.png" width="453" height="255" />
            <title>Scene 1</title>
        </lockup>
        <lockup>
            <img src="path to images on your server/Car_Movie_500x600.png" width="500" height="600" />
            <title>Scene 2</title>
        </lockup>
        <lockup>
            <img src="path to images on your server/Car_Movie_308x308_B.png" width="308" height="308" />
            <title>Scene 3</title>
        </lockup>
    </section>
</carousel>
```

### Subelements of carousel

- [section](/documentation/TVML/section)

### Elements that Use carousel

- [collectionList](/documentation/TVML/collectionlist)
- [showcaseTemplate](/documentation/TVML/showcasetemplate)

## Topics

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