How can we help?

Apple TV Top Playlists Follow

Within an Apple TV app, Top Playlists are designated playlists you can place within slider images at the top of your app as previewed below:


Top Playlist Restrictions

Playlists that can be opened from top sliders are located directly under 'Root' playlist in the Playlists > Manage Relationships section.


At the example above playlists that can be used as a top playlist are: Set of Playlists, Live Recordings, Main Playlist and Series.

To create these playlists in the CMS, you will need to create a titled Top Playlists. Follow the instructions below to do so.

Step 1: Create the Zobject

In your Zype account, click the settings gear in the top right corner. Select Zobject Types from the menu. On the Zobjects Type page, click "New Zobject" in the top right corner.

Fill out the Zobject Details with the following information:

  • Title: top_playlists
  • Videos Enabled: On

You will create two custom attributes for your Top Playlist Zobject:

Playlist ID: This allows you to associate playlists to the Top Playlist

  • Name: playlistid
  • Type: String
  • Show List: Visible

Priority: This allows you to determine the order of the Top Playlists. The highest number will be the first playlist displayed. 

  • Name: priority
  • Type: integer
  • Show List: Visible

Click Save Changes at the bottom of the page. Here is what the completed Zobject should look like:


Step 2: Add Top Playlists

You will now select playlists you want to promote at the top of the app to be your top playlists. We suggest selecting 2-4 playlists.

Tip: Select the playlists you want to use before following the directions below. You will need the title and playlist ID of the playlists you want to use, and it will be helpful to gather this information before creating the Top Playlist. Refer to the screenshot below for the information you need from a playlist to create a Top Playlist:


To start adding Top Playlists, select your "Top Playlist" Zobject on the left hand side of your Zype account. On the Top Playlists page, click "Add New Top Playlist" at the top right corner.

You will now use the information from the playlist you are using to create a Top Playlist. You need the following information:

  • Title
  • Friendly Title
  • Playlistid


Click "Save Changes" at the bottom of the page when the required information is filled out.

Step 3: Adding Top Playlist Images

Each Top Playlist requires an image. The Top Playlist image should be in the following format:

  • 1740 x 700px, JPG

To add an image to a Top Playlist, click into the Top Playlist. From the Edit Top Playlist page, click the Images tab at the top of the page. 

Click the Add Image button and add the image file, then click Save Changes at the bottom of the page. You will see the image preview when an image is added successfully:

Step 4: Top Shelf Image

The top shelf image and top shelf image wide are added in the app building process on your Video Apps tab.

Click into 'Edit Advanced Settings' of your Apple TV app:


Choose the 'Build Details' tab and upload Top shelf image & top shelf image wide from here:



Step 5: Click 'Save Advanced Settings' at the bottom of the page







Article is closed for comments.