<!--
{
  "availability" : [
    "tvOS: 13.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "TVServices",
  "identifier" : "/documentation/TVServices/TVTopShelfSectionedItem",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "TV Services"
    ],
    "preciseIdentifier" : "c:objc(cs)TVTopShelfSectionedItem"
  },
  "title" : "TVTopShelfSectionedItem"
}
-->

# TVTopShelfSectionedItem

An item to display in a section-based interface.

```
class TVTopShelfSectionedItem
```

## Overview

Create a [`TVTopShelfSectionedItem`](/documentation/TVServices/TVTopShelfSectionedItem) object for each item you want to display in the top shelf. Each sectioned item corresponds to one item of your app’s content. For example, a video playback app uses sectioned items to represent movies or shows. Specify the image for the item using the [`setImageURL(_:for:)`](/documentation/TVServices/TVTopShelfItem/setImageURL(_:for:)) method. Use the inherited [`playAction`](/documentation/TVServices/TVTopShelfItem/playAction) and [`displayAction`](/documentation/TVServices/TVTopShelfItem/displayAction) properties to let the system know what to do when the user interacts with the item.

## Topics

### Setting the Image Shape

[`var imageShape: TVTopShelfSectionedItem.ImageShape`](/documentation/TVServices/TVTopShelfSectionedItem/imageShape-swift.property)

The aspect ratio of the item’s image.

[`enum ImageShape`](/documentation/TVServices/TVTopShelfSectionedItem/ImageShape-swift.enum)

Constants indicating the aspect ratio of an image.

### Setting the Playback Progress

[`var playbackProgress: Double`](/documentation/TVServices/TVTopShelfSectionedItem/playbackProgress)

The percentage of the content that the user has already played, specified as a value between 0.0 and 1.0.

## Relationships

### Conforms To

[`NSObjectProtocol`](/documentation/ObjectiveC/NSObjectProtocol)

[`CustomStringConvertible`](/documentation/Swift/CustomStringConvertible)

[`Equatable`](/documentation/Swift/Equatable)

[`Hashable`](/documentation/Swift/Hashable)

[`CustomDebugStringConvertible`](/documentation/Swift/CustomDebugStringConvertible)

[`CVarArg`](/documentation/Swift/CVarArg)

### Inherits From

[`TVTopShelfItem`](/documentation/TVServices/TVTopShelfItem)

---

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)