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

# imageShape

The intended aspect ratio or shape of the content image.

```
var imageShape: TVContentItemImageShape { get set }
```

## Discussion

When the TV Content object is being used to represent Top Shelf items, then the allowed values for this property depend on the [`topShelfStyle`](/documentation/TVServices/TVTopShelfProvider/topShelfStyle) property of the object that implements the TV TopShelf extension. For more information, see [`TVTopShelfProvider`](/documentation/TVServices/TVTopShelfProvider).

If the [`topShelfStyle`](/documentation/TVServices/TVTopShelfProvider/topShelfStyle) value is [`TVTopShelfContentStyle.inset`](/documentation/TVServices/TVTopShelfContentStyle/inset), the valid values of this property are:

- [`TVContentItemImageShape.extraWide`](/documentation/TVServices/TVContentItemImageShape/extraWide)

If the [`topShelfStyle`](/documentation/TVServices/TVTopShelfProvider/topShelfStyle) value is [`TVTopShelfContentStyle.sectioned`](/documentation/TVServices/TVTopShelfContentStyle/sectioned), the valid values are:

- [`TVContentItemImageShape.poster`](/documentation/TVServices/TVContentItemImageShape/poster)
- [`TVContentItemImageShape.square`](/documentation/TVServices/TVContentItemImageShape/square)
- [`TVContentItemImageShape.HDTV`](/documentation/TVServices/TVContentItemImageShape/HDTV)

If the value of this property is not valid for the current Top Shelf style, the system reserves the right to scale the image in any way.

---

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)