Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support
Skip to main content
You submit a Vega OS app through the Developer Console using the same submission process as you do for Fire OS apps. For detailed instructions of the entire app submission process, see Submit Your App to the Amazon Appstore. If you have an existing Fire OS app and want to add a Vega OS version, or if you want to submit a new app for both Fire OS and Vega OS devices, review the guidance on this page.

Prerequisites

The following are prerequisites to submit a Vega OS app:
  • You must have a VPKG file available as an app binary.
  • Your app must register the main category (com.amazon.category.main) in the app manifest. Without the main category, 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.

Considerations for targeting Fire OS and Vega OS devices

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. Although not recommended, you can also choose to submit your Vega OS binary as a new app submission for Vega OS devices only, separate from the Fire OS version of your app. If you have a paid app, or use in-app purchases, this method would require a customer to separately pay for each app and any in-app purchases. The following table lists the differences between submitting the Fire OS and Vega OS version of your app as part of the same app listing, and submitting them as a separate apps.
Area for considerationSame app listing with release tracksSeparate app submission
App metadataMetadata like app title, description, pricing, and screenshots, needs to be completed only one time.You must maintain metadata like app title, description, pricing, and screenshots, separately for Fire OS and Vega OS apps.
In-app purchasesIn-app purchase items added in the Developer Console are automatically available for both Fire OS and Vega OS apps.You must separately set up in-app purchase items for the Fire OS and Vega OS apps. A customer who is entitled to content on the Fire OS app won’t be entitled to the content in the Vega OS app.
Customer reviewsCustomer reviews for the Fire OS app and Vega OS app are shown together.Customer reviews for the Fire OS app and Vega OS app are separate.
App discoveryWhen you search for the app on the Amazon retail website, only one app is listed.When you search for the app on the Amazon retail website, the Fire OS app and the Vega OS app are listed separately.
PricingYou can maintain the same pricing for the app and in-app items for both Fire OS and Vega OS.You can maintain same or different pricing for the app and in-app items for Fire OS and Vega OS. However, the entitlements will not be interchangeable.
App acquisitionIf a customer purchased the app on another compatible Amazon device, they own the app and the in-app purchases associated with the app. Whether the customer downloads the app on a Fire OS or Vega OS device, they retain access to their purchases.The customer must purchase the Vega OS app and in-app purchases separately from the Fire OS app.
If you use the recommended method and 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.
For complete details on each screen in the submission process, see Submit Your App to the Amazon Appstore.

Manage app updates and versions

You can submit updated versions of your Vega OS app in the Developer Console. Defining an app version helps the Amazon Appstore determine which version to show your users. Versioning is critical because:
  • Other apps—including apps you publish as a suite—need to query the system for your app’s version to determine compatibility and identify dependencies.
  • Services where you publish your app might also need to query your app for its version so that they can display the version to users. A publishing service might also need to check the app version to determine compatibility and establish upgrade or downgrade relationships.
The Appstore uses the build number value to protect against downgrades by preventing users from installing a VPKG with a lower build number than the version currently installed on their device. For more information about setting the version and build number for your Vega VPKG, see .

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.

Last modified on November 16, 2026