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

# oneupTemplate

Creates a page that allows users to navigate between full-screen images.

## Overview

Use the `oneupTemplate` element to display a single, full-screen image. Users can
navigate left or right on the remote to select another image. Activating an up action
on the remote will shrink the image and allow a description to be displayed. The
following figure shows the basic layout for a `oneupTemplate` page. The default theme
for a oneup template is `dark`.

![Layout diagram showing a large image area, and a title area followed by a row area at the bottom.](images/com.apple.TVML/oneuptemplate-1.png)

### Main Elements

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

```xml
<oneupTemplate>
    <section>
        <lockup>
            <img />
            <title>…</title>
            <row>
                …
            </row>
        </lockup>
        <lockup>
            …
        </lockup>
    </section>
</oneupTemplate>
```

#### Element Descriptions

- [img](/documentation/TVML/img): The image to be displayed on screen.
- [lockup](/documentation/TVML/lockup): A single image and related text.
- [row](/documentation/TVML/row): Subtitle information relating to the selected image.
- [section](/documentation/TVML/section): Multiple `lockup` elements, each of which contains an item
  to be displayed.
- [title](/documentation/TVML/title): The title to be displayed when a user selects an image.

### Example

The following listing shows the TVML for a `oneupTemplate` example. The example shows
a full screen image, with information about the image displayed along the bottom
of the screen when the user zooms into the image.

```xml
<document>
    <oneupTemplate mode="oneup caption" handlesOverflow="true">
        <section>
            <lockup>
                <img src="path to images on your server/Car_Movie_1920x1080.png" />
                <title>WWDC Roadtrip</title>
                <row>
                    <subtitle>San Francisco</subtitle>
                    <subtitle>June 8, 2015</subtitle>
                </row>
            </lockup>
            <lockup>
                <img src="path to images on your server/Beach_Movie_1920x1080.png" />
                <title>Beach time</title>
                <row>
                    <subtitle>Santa Cruz</subtitle>
                    <subtitle>May 1, 2015</subtitle>
                </row>
            </lockup>
            <lockup>
                <img src="path to images on your server/Space_Movie_1920x1080.png" />
                <title>Spaced out</title>
                <row>
                    <subtitle>Space station</subtitle>
                    <subtitle>July 15, 2015</subtitle>
                </row>
            </lockup>
        </section>
    </oneupTemplate>
</document>
```

The following figure shows the output for the above example:

![Screenshot showing a stylized landscape. A title is directly below the image.](images/com.apple.TVML/oneuptemplate-2.png)

## Topics

### Valid TVML Styles

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

Specifies how an element transitions on and off the screen.

### Valid TVML Attributes

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

[mode](/documentation/TVML/mode)

Specifies how an image 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)