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

# mode

Specifies how an image is displayed.

## Overview

Use the `mode` attribute to define how an image is displayed in the `oneupTemplate`
and `showcaseTemplate` elements. The `showcaseTemplate` element can only use the
`showcase oneup` attribute value. The `oneupTemplate` can only use the `oneup caption`
attribute value. Clicking an image alternates between the selected modes. Here’s
an example that displays images in `showcaseTemplate` in `showcase` mode:

```xml
<document>
    <showcaseTemplate mode="showcase">
        <background>
            <img src="path to images on your server/Car_Movie_1920x1080.png" />
        </background>
        <banner>
            <title>Scenes</title>
            <row>
                <button>
                    <text>Slideshow</text>
                </button>
                <button>
                    <text>Screensaver</text>
                </button>
            </row>
        </banner>
        <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>
            </section>
        </carousel>
    </showcaseTemplate>
</document>
```

### Values for mode

- `showcase oneup`: Image alternates between the actual image size and a fullscreen
  image.
- `oneup caption`: Image alternates between a fullscreen image with or without
  a caption below the image.

### Elements that Use mode

- [oneupTemplate](/documentation/TVML/oneuptemplate)
- [showcaseTemplate](/documentation/TVML/showcasetemplate)

---

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)