<!--
{
  "availability" : [
    "tvOS: 12.0.0 - 18.0.0"
  ],
  "documentType" : "symbol",
  "framework" : "TVMLKit",
  "identifier" : "/documentation/TVMLKit/TVMediaItem/highlightGroups",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Property",
  "symbol" : {
    "kind" : "Instance Property",
    "modules" : [
      "TVMLKit"
    ],
    "preciseIdentifier" : "c:objc(cs)TVMediaItem(py)highlightGroups"
  },
  "title" : "highlightGroups"
}
-->

# highlightGroups

An array containing groups of individual highlights in a media item.

```
var highlightGroups: [TVMediaItem.HighlightGroup] { get }
```

## Discussion

The `highlightGroups` property enables you to show several groups [`highlights`](/documentation/TVMLKit/TVMediaItem/HighlightGroup/highlights) from a stream. Each highlight group in the array contains a list of highlights. Each highlight is an object with the following properties: [`highlightDescription`](/documentation/TVMLKit/TVMediaItem/Highlight/highlightDescription), [`localizedName`](/documentation/TVMLKit/TVMediaItem/Highlight/localizedName), [`imageURL`](/documentation/TVMLKit/TVMediaItem/Highlight/imageURL), and [`TVMediaItem.TimeRange`](/documentation/TVMLKit/TVMediaItem/TimeRange).

For example, consider a video of a baseball game, which is the media item. You can create a highlight group containing the video for each home run —each highlight— in the game. You create another highlight group containing all of the errors. You put these highlight groups into the [`highlightGroups`](/documentation/TVMLKit/TVMediaItem/highlightGroups) property.

---

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)