# Legacy Extension Help users discover your app by providing top shelf content and a description of your tvOS app. ## Discussion In iOS 12 and earlier, you provide Top Shelf information by adding a TVServices app extension to your app. Your extension returns an array describing available content for your app, and the system uses this information to update the Top Shelf. You describe your media to the operating system using [`TVContentItem`](/documentation/TVServices/TVContentItem) objects. Each [`TVContentItem`](/documentation/TVServices/TVContentItem) object represents either a piece of content or acts as a container for other [`TVContentItem`](/documentation/TVServices/TVContentItem) objects. A content object typically includes an image and a title for tvOS to display, along with other metadata related to the content item. > Important: > The memory limits for Top Shelf extensions are significantly lower than the memory limits imposed on tvOS apps. Performing memory-intensive operations in a Top Shelf extension, such as image editing or compositing, could push your extension beyond the high-water mark and force it to be terminated. If you must perform cpu-intensive or memory-intensive operations to generate Top Shelf content, perform those operations on a server and provide URLs to the generated resources. For more information on creating extensions, see [App Extension Programming Guide](https://developer.apple.com/library/archive/documentation/General/Conceptual/ExtensibilityPG/index.html#//apple_ref/doc/uid/TP40014214). In order for tvOS to track content items, you create a unique string for each content item. You can choose your own algorithm to create these identifiers. However, any string you create should identify its content item forever; never recycle identifiers for new content. You package an identifier in a [`TVContentIdentifier`](/documentation/TVServices/TVContentIdentifier) object, which includes the string and the parent container of the item. To summarize, to provide descriptions of content to Apple TV, you must: - Organize your media and app content, either as a single list or in a hierarchical model - Design an algorithm or standard that supplies each content item with a unique content identifier string - Create a [`TVContentItem`](/documentation/TVServices/TVContentItem) object for each container or content item - Add an app extension whose main class implements the [`TVTopShelfProvider`](/documentation/TVServices/TVTopShelfProvider) protocol ## Topics ### Extension [`protocol TVTopShelfProvider`](/documentation/TVServices/TVTopShelfProvider) The interface for providing items to display in the main menu’s Top Shelf user interface on an Apple TV. ### Content [`class TVContentItem`](/documentation/TVServices/TVContentItem) An object that describes either a piece of content or a container for other content items. [`class TVContentIdentifier`](/documentation/TVServices/TVContentIdentifier) An object that uniquely identifies media content in either a single piece or a collection. [`func TVTopShelfImageSize(shape: TVContentItemImageShape, style: TVTopShelfContentStyle) -> CGSize`](/documentation/TVServices/TVTopShelfImageSize(shape:style:)) Returns the ideal size for an image, according to its particular shape and style. --- Copyright © 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)