Asset Catalog Format Reference: Brand Assets Type

The brand assets used for your app in the main TV interface and in the App Store. There are three elements in the brand asset:

App store icon. A layered image used in the App Store.
App icon. A layered image used to represent your app on the Home screen.
Top shelf image. An image displayed when your app is selected in the Apple TV App Launcher.

The icons are image stacks, and the top shelf image is an image set. For information in sizes see the Apple TV Human Interface Guidelines.

Extension

.brandassets

Folder Contents

Image stacks and image sets.

Contents.json File (Required)

Metadata and attributes for the individual icon and top shelf elements (Table 9-1).

**Table 9-1**Brand asset tags
Key	Type	Description
`info`	Dictionary	Metadata for the author and format version of the asset catalog.
`author`	String	Use your bundle ID.
`version`	Number	The format version of the asset catalog. Use `1`.
`assets`	Array of dictionaries	The icon and top shelf elements in the brand.
`idiom`	String	The platform for the element. The value must be `"tv"`.
`filename`	String	The name of the asset catalog folder containing the branding element.
`role`	String	The role of the element. See role below.
`size`	String	The horizontal and vertical size of the element. The form is `"<horizontal-size>x<vertical-size>"`.

Values for Enumerated Tags

role

The role of the element in the brand (Table 9-2).

**Table 9-2**`role` values
Value	Description
`primary-app-icon`	The main icon for the app. The primary icon can have multiple sizes.
`top-shelf-image`	An image for the top shelf.
`top-shelf-image-wide`	A banner image for the top shelf.

Sample Contents.json File

        {
   "assets" : [
      {
         "size" : "1280x768",
         "idiom" : "tv",
         "filename" : "App Icon - Large.imagestack",
         "role" : "primary-app-icon"
      },
      {
         "size" : "400x240",
         "idiom" : "tv",
         "filename" : "App Icon - Small.imagestack",
         "role" : "primary-app-icon"
      },
      {
         "size" : "1920x720",
         "idiom" : "tv",
         "filename" : "Top Shelf Image.imageset",
         "role" : "top-shelf-image"
      },
   ],
   "info" : {
      "author" : "com.developerName",
      "version" : 1
   }
}

      