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

# background

Displays an image or plays audio in the background of a channel app page.

## Overview

Here’s an example that shows adding an image and audio to a `background` element.

```xml
<background>
   <img src="" />
   <audio>
      <asset id="" src="" keyDelivery="" />
   </audio>
</background>
```

> Note: Audio does not work in the background when the `background` element is contained
> in a `banner` element.

### Subelements of background

- [audio](/documentation/TVML/audio)
- [mediaContent](/documentation/TVML/mediacontent)

### Elements that Use background

- [alertTemplate](/documentation/TVML/alerttemplate)
- [banner](/documentation/TVML/banner)
- [compilationTemplate](/documentation/TVML/compilationtemplate)
- [descriptiveAlertTemplate](/documentation/TVML/descriptivealerttemplate)
- [listTemplate](/documentation/TVML/listtemplate)
- [mainTemplate](/documentation/TVML/maintemplate)
- [organizer](/documentation/TVML/organizer)
- [productBundleTemplate](/documentation/TVML/productbundletemplate)
- [productTemplate](/documentation/TVML/producttemplate)
- [showcaseTemplate](/documentation/TVML/showcasetemplate)

## Topics

### Valid TVML Styles

[background-color](/documentation/TVML/background-color)

Changes the background color of an element.

[color](/documentation/TVML/color)

Changes the color of an element.

### Valid TVML Attributes

[aspectFill](/documentation/TVML/aspectfill)

Stretches an image to fill the containing bounding box.



---

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)