<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "TVServices",
  "identifier" : "/documentation/TVServices",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "TV Services"
    ],
    "preciseIdentifier" : "TVServices"
  },
  "title" : "TV Services"
}
-->

# TV Services

Display content and descriptions, provide channel guides, and support multiple users on Apple TV.

## Overview

Use the TVServices framework to display content prominently on the screen and to speed up user login. You can highlight media and other information from your app in the *top shelf area*. For example, a video playback app might show the user’s most recently viewed videos. The system displays your media items when the user selects your app on the tvOS Home Screen; your app doesn’t need to be running. You provide top shelf content using a Top Shelf app extension, which you include in the bundle of your tvOS app.

Apps that manage multiple user profiles can accelerate the login process by retaining the profile for each Apple TV user. Apple TV supports multiple user accounts, and these accounts are separate from the profiles your app manages. Mapping the system accounts to your own profiles lets users skip profile selection screens and go straight to their content, which provides a better user experience.

> Important:
> Don’t perform memory-intensive operations from your TVServices app extension. The memory limits for app extensions are significantly lower than for apps, and using too much memory might cause the system to terminate your extension. Instead, generate top shelf content and perform other memory-intensive operations on your server.

## Topics

### Top shelf app extensions

[Building a Full Screen Top Shelf Extension](/documentation/TVServices/building-a-full-screen-top-shelf-extension)

Highlight content from your Apple TV application by building a full screen Top Shelf extension.

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

The main interface for your Top Shelf app extension, which you use to provide content for the top shelf area of the tvOS Home Screen.

[Legacy Extension](/documentation/TVServices/legacy-extension)

Help users discover your app by providing top shelf content and a description of your tvOS app.

### Carousel content

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

An item containing images, video, and other information that you want to display using a carousel-based interface.

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

A set of items you present using a carousel-style interface in the top shelf.

### Sectioned and inset content

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

An item to display in a section-based interface.

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

A group of items that you display together in a sectioned interface in the top shelf.

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

The set of items you want to present using a section-based interface in the top shelf.

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

A set of items to present using an inset-style interface in the top shelf.

### Multiple users

[Personalizing Your App for Each User on Apple TV](/documentation/TVServices/personalizing-your-app-for-each-user-on-apple-tv)

Use account-specific storage to segregate data on a multiuser system.

[Supporting Multiple Users in Your tvOS App](/documentation/TVServices/supporting-multiple-users-in-your-tvos-app)

Store separate data for each user with the new Runs as Current User capability.

[Mapping Apple TV users to app profiles](/documentation/TVServices/mapping-apple-tv-users-to-app-profiles)

Adapt the content of your app for the current viewer by using an entitlement and simplifying sign-in flows.

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

An object that indicates how to store preferences for multiple people on a shared device.

### Channel guide

[Providing Channel Navigation](/documentation/TVServices/providing-channel-navigation)

Support browsing an electronic program guide (EPG) and changing channels with specialized remote buttons.

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

An activity for viewing your app’s channel guide.

### Common types

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

An item that uses an image to represent a movie, show, or other content in the top shelf.

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

An action to perform in response to user interactions with an item in the top shelf.

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

The protocol that objects adopt to provide content for the top shelf.

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

An abstract base class for describing top shelf items and item collections.


---

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)