Create Your App
After you create and preview your app, you're ready to publish your app on the Amazon Appstore. When you start the app publishing process, Amazon Creator attempts to auto-create some of the required image assets for Appstore submission, but not all image assets are available from your YouTube channel or MRSS feed. Consequently, you will need to manually create some image assets. The publication details will also require you to add descriptions and metadata about your app.
If you're using YouTube as the video source, next to API Key, click Edit, and enter your YouTube API key.
For details on how to get your YouTube API key, see Get the YouTube Developer API Key. (You can use the same API key for all YouTube channels in your account and for all apps you create for these apps. Note that the API key does not restrict others from creating apps using your YouTube channel — it just allows you to play videos outside of YouTube.)
Click Publish next to your app.
If you don't already have an Amazon Developer Account, you're prompted to create one. If so, you'll be directed into the Developer Console to create the account. Complete the information on the 1. Profile tab. Accept the agreement on the 2. App Distribution Agreement tab. On the 3. Payments tab, select No for the monetization options, since Amazon Creator doesn't provide monetization options (if you already have payments configured, that's fine — you can leave it as is). After you finish signing up for your Developer Account, you'll be redirected back into the Amazon Creator app.
Amazon Creator prepares for app submission by automatically creating some of the required image assets.
Although Amazon Creator auto-generates some of the assets (using what's available in your YouTube channel or MRSS feed), you should upload a more suitable Fire TV App Icon and Fire TV Background Image.
For example, the Fire TV App Icon dimensions are supposed to be 1280x720px, but because Amazon Creator has only a smaller square icon available from YouTube, it renders the required dimensions by applying a zoomed-in/blurry background with the square icon superimposed on top of it. This image is meant to be replaced.
Upload the required image assets and supply the descriptions required by the Appstore. To change the images shown in the Amazon Creator interface, click the image titles and upload new ones. See the following sections for image and description details.
After completing the required image and description sections, click Publish to Appstore to publish your app or Save (Publish Later) to save your existing work and publish at a later time.
After confirming your actions, you see a "Submission Successful!" message.
You also receive an email from the Appstore saying that your app is "being reviewed as a part of the Amazon app approval process." When the app is live, you will receive another email indicating that it has been published. (Note that the email won't actually contain a link to your app — you must search for your app in the Appstore.)
Your published app will be available on Fire TV in all regions where Fire TV is available (US, UK, Germany, Japan, India, and Austria).
You need to prepare image assets of various sizes to promote your app in the Fire TV Appstore and the Amazon Appstore website. If your image isn't the right size, the image will be scaled up or down by Amazon Creator to fit the right dimensions. However, note that scaling images up makes them fuzzy, and if the aspect ratio isn't correct, the image will be stretched or squished, so use the correct dimensions.
Details for each image asset are provided in the following tabs:
Two icons are required. Both are used to represent your app throughout the Amazon Appstore and on Amazon devices, so use high quality images. The 114 x 114px icon can be a simplified version of the large icon's design that looks better in thumbnail size, while the 512 x 512px icon shows more detail. Or both icons can simply be the same. The icons are scaled down to a smaller size.
Here's a sample small icon (114px x 114px) in the context of the Appstore:
Here's a sample large icon (512px x 512px) in the context of the Appstore:
Do not just scale up the PNG image of your icon — doing so results in a blurry image.
Design Best Practices
The App Icon appears within a row of other app icons in the Fire TV user interface.
Here's a sample App Icon:
Fire TV Context:
The App Icon appears on Fire TV in the following context:
Content Safe Area:
The following badges may appear superimposed on the App Icon:
To ensure your App Icon looks good even with badging (download icons, progress bars, etc.), place your main subject and title art within the content safe area. Artwork that falls outside of the safe area may be covered by badges.
Design Best Practices:
Follow these guidelines when designing your App Icon:
If you don't provide the required Fire TV assets, Fire TV will apply a default creative treatment to the images to scale them to fit the required spaces. For example, if the required image size is larger than any available images you've submitted, your image will be placed on top of background image that fills the space correctly.
When users scroll across your app from a browse page, the Background Image appears in the upper-right corner of a mini-detail page.
The following is an example of a Background Image:
Fire TV Context
The Background Image appears on Fire TV in the following context:
When users click your app icon, the Background Image can also fill the entire background.
Content safe area:
The main focus element of the image must be placed within the content safe area. Artwork that falls outside of the safe area might be covered by UI elements.
Design Best Practices:
Screenshots show images from your app to give users a better sense of what your app offers. Include a minimum of 3 and a maximum of 10 screenshots. For details on taking screenshots, see Taking screenshots on Fire devices.
Here's an example screenshot from the Amazon Music app:
Fire TV Context:
The following image shows screenshots in the context of the Fire TV UI:
Content Safe Area
Screenshots aren't covered by badging, so you don't have to worry about placing content inside a safe area.
Design Best Practices:
Various descriptions are required for your app in the Appstore. See the following details about each description requirement.
A short description of your app that is appropriate for display on a TV or tablet device. The maximum length is 1,200 characters, but consider using a shorter description. (Paragraph breaks get stripped out.) The Fire TV UI displays displays only the first 200 characters, then shows an ellipses to read more. Optimize your short description to include the most important information up front.
A lengthier description of your app that is appropriate for use on the Amazon Appstore website. The maximum length is 4,000 characters. The long description appears in the Appstore website only, not on tablet or Fire TV devices. Note that all text input fields (including the short description and other fields) are plain text only. Do not enter HTML markup (it will fail testing and delay your app's publishing).
Three to five key features of your app, one feature per line. Press Return after each feature. Each line will automatically be converted to a bulleted list item when you press Return.
Comma-separated search terms that will help customers find your app in the Amazon Appstore. These keywords can be helpful in surfacing your app when users search Fire TV, either by text or with voice.
All apps published to the Amazon Appstore must adhere to the Content Guidelines that are described in Amazon Appstore Content Policy Requirements. If Amazon determines that an app contains, facilitates, or promotes content that is prohibited by these guidelines, Amazon will reject the app submission or suspend further distribution of your app and notify you at the email address associated with your developer account.
To view the status of your published app:
The following are the possible submission states and details for your app:
Although it's technically possible, don't try to update your app's metadata (images, description, and so on) from the Amazon Developer Portal at https://developer.amazon.com. Any updates you make in the Developer Portal DO NOT flow back into Amazon Creator. If you modify your app details (for example, updating descriptions, images, or other metadata) from within the Developer Portal, your app in Amazon Creator will not reflect those changes.
Amazon Creator was designed for you to publish your app to the Appstore entirely from the Amazon Creator site, without ever logging in to the Developer Portal. Although you have an Amazon developer account (which you're prompted to create when you publish your app), the account's purpose is to allow Amazon Creator to interact with the Developer Portal site.
Getting your app into the Appstore is just the first step to developing a successful app. For your app to be widely downloaded and viewed, you'll need to promote your app as much as possible. The Amazon Developer blog often publishes tips on marketing. See the following posts:
© 2018 Amazon, Inc.