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

# progressBar

Places a progress bar on top of another element.

## Overview

The `progressBar` element creates an empty bar that is overlaid along the bottom
of an image. A percentage of the bar is then filled based on the value assigned.
This element is commonly used to denote how much of a media item has already been
viewed.

### Contained In

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

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

[value](/documentation/TVML/value)

Specifies the value used for a fillable 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)