Submitting Your tvOS Apps to the App Store

tvOS 12 will soon be available to customers around the world. Prepare and submit your tvOS apps and product page metadata to the App Store for Apple TV.

Build with the tvOS 12 SDK.

Update to the latest version of Xcode 10, which includes the tvOS 12 SDK, and build your apps. Take advantage of frameworks and technologies such as TVUIKit, TVML, and Metal to create apps that look amazing on Apple TV. All libraries and frameworks used in tvOS apps must be built for tvOS, including any third-party libraries. Make sure your tvOS app doesn’t link against frameworks or libraries built for iOS.

Use On-Demand Resources

Your submission may contain up to 4GB in the main bundle and up to 20GB of On-Demand Resources. To enable smaller app bundles, faster downloads, and more app content for your tvOS app, use On-Demand Resources to request content hosted on the App Store that is separate from your main app bundle.

For more information, see the Xcode Help Guide.

Xcode icon
Xcode 10

Xcode provides everything you need to create great apps for Apple platforms. Xcode 10 includes SDKs for iOS 12, watchOS 5, tvOS 12, and macOS Mojave.

Optimize Your Design

Apple TV redefines the living room experience, allowing you to deliver immersive content on the big screen like never before. And the Apple TV Remote brings the touch experience to your apps on Apple TV.

Leverage the remote’s touch surface, accelerometer, and gyroscope to deliver a compelling and intuitive experience. Use the native focus model to display subtle animations and the parallax effect to create various states of depth as a user focuses on different elements in the UI. And make sure your app interacts with the remote buttons consistently and predictably.

For details, see the Human Interface Guidelines.

Get your product page ready.

App Name

Searching by app name is a key way users find apps on the App Store for Apple TV. Search is incremental, so users see results each time they type a letter. Keep your tvOS app name short to help users quickly find what they're looking for. If your tvOS app uses the same app ID as your iOS app, the apps will share one name. If your tvOS app uses a separate app ID, you'll need to create a new name. Do not include the phrases Apple TV, tvOS, or ATV in your app name. Apple TV is a trademark and should always be written in English, even when it appears within text of another language.

App Icon

Layered images are required to support the parallax effect that creates the sense of depth and vitality for icons on Apple TV. For guidance on creating app icons and specifications, see the Human Interface Guidelines.

Description

Your tvOS app has its own app description. Use the description to explain the ways in which the app is optimized for a large screen and how the app leverages the features of the Apple TV Remote to create an immersive, intuitive experience.

Keywords

Your tvOS app has its own unique set of keywords, with a limit of 100 characters. Maximize the number of words that fit in this character limit by avoiding terms such as TV, television, and app. Do not use the phrases Apple TV, tvOS, or ATV. Apple TV is a trademark and should always be written in English, even when it appears within text of another language. For more information on writing effective keywords, read Making the Most of Your Product Page.

Screenshots

You can upload up to 10 screenshots of your tvOS app. Take advantage of all 10 to fully highlight your app's features. Use the entire space for the screenshot — do not frame screenshots in a TV. For compatibility with the new Apple TV 4K, App Store Connect supports screenshots that are 3840 by 2160 pixels, as well as 1920 x 1080 pixels. For details on uploading screenshots, see the App Store Connect Help.

App Previews

App previews demonstrate the features, functionality, and user interface of your app or game in a short video that users can watch by selecting the preview button on an app’s product page. Each preview can be up to 30 seconds long and appears in all countries or regions where your app is available.

Learn more about app previews

App Store Connect Icon
App Store Connect

Find details and step by step instructions on how to upload your app’s icon, app preview, screenshots, and metadata in App Store Connect.

Test and submit your app.

Before submitting your app for review in App Store Connect, make sure that it adheres to the review guidelines, and it’s ready to be released to customers.

Beta Testing with TestFlight

Before finalizing your app for release, get valuable feedback with beta testing to make sure it’s ready for your customers. Upload your apps to App Store Connect and use TestFlight to install and test them on an Apple TV.

Learn more about TestFlight

App Thinning

When compiling your tvOS app and any third-party libraries, Bitcode must be enabled. Your main app bundle is limited to 4GB. Your submission can include up to 20GB of On-Demand Resources, and the initial download of your app may include up to 2GB of On-Demand Resources.

For more information, see the Xcode Help Guide.

Universal Purchase

Let your customers enjoy your app on both iOS and tvOS with a single purchase on the App Store. By enabling universal purchase of your app in App Store Connect, you can provide a seamless experience for your users on iPhone, iPad, and Apple TV. When users download an app on an iPhone or iPad that also has an Apple TV version, the app can be automatically added to the Home screen of any Apple TV signed in to the same account.

For more information, see the Universal Purchase of iOS and tvOS Apps.

Review Guidelines

All apps submitted to the App Store are reviewed based on a set of technical, content, and design criteria. Make sure to review the guidelines before submitting your app for review.

Promote your tvOS app.

Use the Download on the App Store badge, Apple TV images, and recommended messaging when promoting your tvOS app on the App Store.

Messaging

When marketing your tvOS app, direct users to the App Store for Apple TV and provide a clear call-to-action to search for your app by its exact name. Include your app icon in your marketing creative to help users connect your marketing message with the app as it appears on the App Store on Apple TV. Alternatively, you can provide a link to your tvOS product page on the App Store for iPhone and iPad to give users another way to download your app to Apple TV. If your app is only for Apple TV, highlight this with a phrase such as “Exclusively for Apple TV”. If your app is already available for iPhone and iPad, promote your new tvOS app to existing iOS users with phrases such as “Also Available on the App Store for Apple TV” or “Now Available on the App Store for Apple TV”.

Linking to tvOS Apps

Product pages for tvOS apps are also available on the App Store for iPhone and iPad. Customers who have enabled their Apple TV to automatically install apps can download your app straight to Apple TV from their iOS device or computer when they follow a direct link to your product page. Simply get the link from iTunes Link Maker and use it when promoting your app. While tvOS apps with universal purchase are discoverable on the App Store for iPhone and iPad through searching and browsing, apps exclusively on the App Store for Apple TV can only be found through this direct link.

App Analytics

Measure user engagement and monetization for your tvOS apps with App Analytics in App Store Connect. In addition to seeing data on product page views, downloads, and engagement, you can see how many iOS users acquired with your marketing campaigns opened the same app on Apple TV. You can also promote your tvOS app in another tvOS app and track the results using campaign links.

Learn more about App Analytics

Download on the App Store
Download Artwork

Display your tvOS app in Apple TV images approved by Apple to introduce users to your app on this platform. If your app is also available for iPhone and iPad, use the overlapping product image to display your app on all devices. You can also use the Download on the App Store badge as a clear call-to-action in your marketing communications.