Submission requirements
Before starting the app submission workflow, make sure you have the following available:-
App binary file:
- For Fire OS, an APK or Android App Bundle (AAB) file. For details on Android development, see Android developer documentation.
-
For Vega OS, a VPKG file. For details on Vega OS development, see Build Your App in the Vega OS developer documentation. If you need to port your existing Fire OS app to Vega OS, see Port Your Fire OS App to Vega.
Make sure your Vega OS app registers the
maincategory (com.amazon.category.main) in the manifest. Without themaincategory, your app can’t launch from the Fire TV Home launcher and will fail the Amazon Appstore submission process. For more information, see Manifest [components] Section in the Vega OS developer documentation.
- An Amazon developer account.
- Image assets and descriptions for your app.
- A physical device to test your app on. Testing your app on a physical device is an essential step to make sure you provide users with an optimal experience. For any questions or concerns regarding this requirement, please contact Amazon developer support.
Release tracks for Fire OS and Vega OS
If you plan to target both Fire OS and Vega OS devices, you can submit the binaries using the same app listing in the console. For example, if you have an existing Fire OS version of your app, you can add the Vega OS version to your existing app. An individual app listing can have separate release tracks. When you use release tracks, your Fire OS and Vega OS app still share the same Amazon Standard Identification Number (ASIN), but you manage the binary files separately. Metadata and other app features, such as in-app purchasing, are shared across both versions. When you submit both Fire OS and Vega OS binaries to the same app listing, make sure your app meets the following conditions:- Your package name for both the Fire OS binary and Vega OS binary are the same.
- If your app supports in-app purchasing (IAP), your app has Vega IAP libraries integrated.
Guidelines for maintaining multiple APKs and VPKGs
You can submit both APKs and VPKGs in the same app listing and must maintain versioning for both binary types. Since each binary has a distinct development process, follow these guidelines for versioning your APKs and VPKGs:- The Fire OS version codes and Vega OS build numbers are independent of each other. When you submit both APKs and VPKGs for an app, the Appstore checks the new version code with the version code of the previous APK submission, and checks the new build number with the build number of previous VPKG.
- For app updates, both the version code and build number need to be greater than the previous version code and build number respectively.
App submission in the Developer Console
In the Developer Console, you can access the app submission workflow. The workflow has two primary parts:- App Setup – This is where you add store listing information, pricing, and other details about your app. The App Setup section has the following subsections:
- Release Tracks – This is where you add release details for your app. The Release Tracks section is where you create, target, and submit releases for your app. In this section, you upload your app’s binary files and indicate the supported devices for each binary. If you have both a Fire OS and Vega OS version of your app, you manage those release tracks separately on this page.

App submission workflow sidebar
for that section in the sidebar. You will not be able to submit your app until the App Setup section shows a green check mark.
For a broader overview of the app submission process, see Understanding Amazon Appstore Submission.
Additional configurations
Depending on your app’s functionality, you might need to do some additional steps not listed in the workflow shown in the previous section:- In-app purchasing: If your app contains items available for in-app purchasing (IAP), you must enter those on the In-App Items tab before submitting your app. For instructions, see Create and Submit Single IAP items for Fire OS and Submit IAP Apps for Vega OS.
- Security Profile: If your app uses Login with Amazon, or Amazon Device Messaging APIs, be prepared to associate your app with a security profile as part of the submission process. For more details, see Security Profile in the Login with Amazon documentation.
Get started
Before you can submit an app, you must register for a developer account (it’s free) and add an app within the Developer Console. If you already have an app created in the Developer Console, you can sign in, select My Apps, and find your app.
App List in the Developer Console
- Go to Developer Console and sign in. If you already have an Amazon.com account but not an Amazon developer account, sign in with your Amazon.com account. The Developer Console creates the developer account using your Amazon.com email address, and then the two accounts are tied together and synced. You will be prompted to complete the registration profile pages in the Developer Console. After you sign in, the Developer Console shows the Dashboard page for your account.
-
From the Dashboard, in the Amazon Appstore widget, click Add a New App.

