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

# badge

A small image displayed alongside or on top of another image.

## Overview

The `badge` element contains a link to a small image that is displayed, often with
another image. This element is commonly used to display images that provide additional
information about the element in which they are contained. The following listing
shows an example of a `badge` element.

```xml
<badge src="Path to image" alt="additional identifier" accessibility="" />
```

### Contained In

- [buttonLockup](/documentation/TVML/buttonlockup)
- [header](/documentation/TVML/header)
- [lockup](/documentation/TVML/lockup)
- [organizer](/documentation/TVML/organizer)
- [overlay](/documentation/TVML/overlay)
- [row](/documentation/TVML/row)
- [text](/documentation/TVML/text)
- [title](/documentation/TVML/title)

## Topics

### Valid TVML Styles

[margin](/documentation/TVML/margin)

Specifies the spacing around an element.

[tv-highlight-color](/documentation/TVML/tv-highlight-color)

Changes an element’s color when it comes into focus.

[tv-tint-color](/documentation/TVML/tv-tint-color)

Sets the tint color for an element.

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

[src](/documentation/TVML/src)

Specifies the URL for an image.

[srcset](/documentation/TVML/srcset)

Specifies multiple URLs for an image.

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