Skip to main content
Preparing My TV App Visual Assets

Best practices for formatting your TV app icon and Top Shelf image

Updated today

tvOS App Visual Asset Requirements

Size

File Details

App Icon

(min. 2, max. 5 separate layers)

1280x768px

Filename: tvOS_storeIconLayer[#].png
​
Top layers must have transparency;
Bottom layer must be solid

Top Shelf Image

3840x1440px

Filename: tvOS_topShelf.png
​
Must not have transparency

Top Shelf Wide Image

4640x1440px

Filename: tvOS_topShelfWide.png
​
Must not have transparency

In this article, you'll learn about the specific visual assets you will need to provide in order to launch your TV app with Viewcastle.


App Icon

1280x768px

This will be the icon for your Apple TV app, both as it appears in the Apple TV App Store as well as on your users' home screen. tvOS app icons use between two and five layers to create a sense of depth and vitality as users bring them into focus.

For more details and best practices on designing app icons for tvOS, see Apple's app icon guidelines.

Top Shelf Image

512x512px (standard)

4640x1440px (wide)

The Apple TV Home Screen provides an area called Top Shelf, which showcases your content in a rich, engaging way while also giving people access to their favorite apps in the Dock. Apple recommends taking advantage of their options for displaying dynamic content, but at minimum a static image is required.
​
This image (in both standard and wide versions) will be the fallback if dynamic content is unavailable. It will display when your app is in the Dock and in focus. tvOS flips and blurs the image in the area below the Top Shelf, ensuring that your image overall fills the 16:9 aspect ratio of the screen.

For best practices about Top Shelf content, see Apple's Top Shelf guidelines.


Ready to submit your visual assets?
Click below to upload them through your onboarding portal:

Sign into your personalized portal by entering your email address. (If you haven't yet begun the onboarding process, reach out to sales@viewcastle.com to get started!)

Once signed into your portal, open the task "Complete tvOS details." Complete the form with the info you'd like to be in your Apple TV Store listing and upload your visual asset files, then click "Submit." Our team will review your information and add it to your app listing through your Apple Developer Account. You can also modify your listing's information and assets at any time through this account.

Did this answer your question?