Developer Console

Understanding Amazon Appstore Submission

Amazon's goal is to make app submission for Android apps simple and easy. Most of the time, your Android app should just work on Amazon Fire devices without modifications. This page explains the key concepts for publishing apps for Fire tablets and other Android-based devices to the Amazon Appstore.

High-Level Review of Submission Prerequisites

Publishing to the Amazon Appstore requires the following:

  • Amazon customer account: If you do not have an Amazon customer account, create one at

  • Amazon developer account: If you do not have an Amazon developer account, go to the Amazon Apps & Games Developer Portal, and sign in with the same email address as your Amazon customer account. The portal will guide you through the account creation process.

  • An Android app that you want to publish to the Amazon Appstore: Each app that you submit must comply with Amazon's content policy. If Amazon determines that an app contains, facilitates, or promotes content prohibited by these guidelines, Amazon will reject the submission. See Amazon Appstore Content Policy.

  • Image assets for product promotion. You must provide screenshots and large and small icons for promoting your app on the Amazon Appstore. You may optionally provide a promotional image and videos. See Image Asset Guidelines.

  • Intellectual Property (IP) Documentation (if needed): If your app uses intellectual property (IP) from a third party, be prepared to submit documentation that you have obtained the proper license or permission to use that IP in your app.

Overview of the App Submission Process

The following high-level overview can help you understand the general process for submitting an app to the Amazon Appstore:

  1. Develop or Migrate: Develop your app from scratch or migrate an existing Android app for publishing in the Amazon Appstore. (See Migrating an Existing App to the Amazon Appstore.) Keep in in mind the Amazon Appstore Content Policy as you design your app.
  2. Test: Make sure that your app meets the Test Criteria for Amazon Appstore Apps. You can also use one of Amazon's testing services to validate your app's functionality. See Testing Your App for the Amazon Appstore.
  3. Submit Your App: Login to your developer account, enter the appropriate information for your app's listing in the Amazon Appstore, and upload your app. See Submitting Apps to the Amazon Appstore.
  4. Respond to any failure notifications (if needed): If your app fails any submission criteria, you will receive a notification that the app has been rejected. Fix your app as directed, and resubmit your app. See Viewing App Submission Status.
  5. Update your app (as needed): If you need to make changes to an app that has already gone live in the Amazon Appstore, see Updating a Published App.

General Tips for Successful App Submission

Use the following recommendations to make your publishing experience as smooth as possible.

Accounts and Email Communication

  • Your Amazon customer account is tied to your Amazon developer account. Any changes you make to the sign-in credentials of your Amazon customer account are propagated to your Amazon developer account, and vice versa.
  • Amazon will only send email to the address listed in the company profile when corresponding with you about your app's status. When you set up a new Amazon Apps & Games Developer Portal account, you are the default account administrator. You can add other people in other roles to the account, such as analyst, developer, or marketer. You can also add other administrators. Although any developer or administrator can submit an app, Amazon will send correspondence only to the email address in the company profile. Amazon will not send messages to the email account associated with the person who submitted the app, unless that person's email address is the email address in the company profile. To see which email address is listed, an account with administrator permissions can check the Company Profile on the Settings tab.

App Preparation

  • Version Name: In your AndroidManifest.xml file, use the android:versionName attribute for version information to display to users. On the Amazon Appstore, the android:versionName is required, can be any string, and must be fewer than 50 characters.
  • Version Number: android:versionCode must increase for each successive version of your app. As per the Android documentation on <manifest>, the android:versionCode in AndroidManifest.xml must be an integer whose value increases each time a new version of your app is released. If your app's android:versionCode does not follow this convention, customers will not receive the new version of your app.
  • Device filtering: In your AndroidManifest.xml file, specify which Android devices you are targeting with your app. See Device Filtering and Compatibility.

Best Practices for 64-bit APK submission

The Amazon Appstore accepts hybrid 32-bit/64-bit APK submissions for some Fire tablets (11th generation and above). This means to reach all Amazon devices, you should develop with 64-bit in mind. These two library folders must have the correct files:

  • 32-bit folder: lib/armeabi-v7a/
  • 64-bit folder: lib/arm64-v8a/

For every library in one folder, there must be a corresponding library in the other folder. If you have a 32-bit library in the 32-bit folder, but do not have that same library in 64-bit format in your 64-bit folder, your application may crash or freeze on a device, or have In-app Purchasing (IAP) failures.

64 bit error message
64 bit error message

Preparing the APK File for Your App

This section discusses Amazon's recommendations for creating the APK file that you will submit for your app.

Zip-aligning Your APK

When you generate your APK from Android Studio, your APK is aligned by default. (Alignment refers to optimization of the APK files.) However, if you're not using Android Studio to generate your APK, you might need to zip-align your APK before uploading the APK in the Developer Portal. See zipalign in the Android documentation for details.

If you submit an unaligned APK, the Developer Portal will reject it, with a message saying, "The submitted APK does not appear to be zip-aligned. Please zip-align your APK and resubmit your application."

If you see this message, you can zip align your APK with Android Studio by running the following command:

[Android SDK location]/tools/zipalign -v 4 <Original.apk> <Aligned.apk>

(You can find your Android SDK location in Android Studio by going to Tools > SDK Manager. Then you would replace [Android SDK location] with a path such as /Users/johndoe/Library/Android/sdk.)

In addition to zip-aligning your APK, if you're using AndroidX library for multidexing, keep the AndroidX library unobfuscated in your code by adding this line to your Proguard file:

-keep class androidx/multidex.** { *; }

Amazon App Signatures

When you submit your app, Amazon removes the signature you used to sign your app and re-signs it with an Amazon signature that is unique to you, does not change, and is the same for all apps in your account.

You can find the Amazon signature hashes for your account by selecting any application in the developer console and navigating to the APK Files tab. The SHA-1, MD5, and SHA-256 hashes for your account are listed in the Appstore Certificate Hashes section. Upon request, Amazon can also provide the hashes for the Public Key exponent, Public Key modulus, and Facebook.

Amazon's Code Wrapper

When you submit your APK to the Amazon Appstore, Amazon adds a wrapper to your code that includes metadata and an application signature. Amazon wraps your APK with code for the following purposes:

  • To collect analytics relating to the app
  • To evaluate and enforce our program policies
  • To share aggregated information with you and others regarding the program
  • To modify and add to your app so we can (at your option) enforce digital rights management (DRM)
  • To add metadata to your app so we can improve their compatibility with Amazon devices

APK Size Limitations

APK files can be up to 2.5GB in size. Amazon recommends, however, that you deploy small APK files that download and install quickly, and then, upon first launch, your apps should download additional resources and save them on the users' local file system. Binary blobs (.obb) are not supported by the Amazon Appstore, so it is up to you to install external resources in the proper path after downloading them at runtime, and to submit an APK compiled without .obb files.

After Amazon's next publish cycle (about every 30 to 90 minutes), you should receive an email from Amazon indicating that your APK was uploaded successfully. When you return to the APK Files tab, you should see your file.

Note that Amazon Appstore does not allow you to use expansion files for large APKs.

Screen Resolutions

When creating the APK for your app, you should consider multiple screen sizes and resolutions. The primary screen size categories are:

  • Small screen
  • Normal screen
  • Large screen
  • Extra-large screen

For each screen size category, the device’s display may be:

  • Low density (120 dpi)
  • Medium density (160 dpi)
  • High density (240 dpi)
  • Extra high density (320 dpi)

Designating Apps as High Density (HD)

To ensure that customers have a great HD experience on Fire tablets, your app must meet the following requirements to gain an "HD" designation in the title of your app:

  • The app is designed for high-density screens (hdpi or xhdpi) and declares this support in the manifest
  • The app’s drawables are optimized for high-density screens (images can be rendered at native resolution)
  • The app uses the entirety of the screen (without letterboxing)
  • Video content in the app (if applicable) must be at least 24 frames per second and 720p (in video-focused applications)

If you believe your app meets these requirements and should be identified as HD on the product detail page, include the notation "Please review for HD designation" in the Testing Instructions field when you submit your app. See the "Testing Instructions" section when uploading APK files or webapps.

For information about making your app look good on Kindle Fire tablets, see Screen Layout and Resolution.

Specifying an Installation Location for Your App

Your Android Manifest file specifies the installation location for your app on Fire TV and Fire tablet devices. For most apps, setting this value to External Storage (preferExternal) will provide a better experience for your app's users. For more information, see the following:

About DRM (Digital Rights Management)

When your app starts on a Fire device, it communicates with the Amazon Appstore client to determine whether the current user is entitled to use your app. In the "Apply Amazon DRM?" field on the APK Files tab, if you select Yes, Amazon DRM is enabled, and your app will run only if the signed in user has an entitlement to your app. If you select No, DRM is not enabled and the app will run no matter who is signed in.

Regardless of whether you choose to apply Amazon DRM, Amazon wraps your app with code that enables the app to communicate with the Amazon Appstore client to collect analytics, evaluate and enforce program policies, and share aggregated information with you. Your app will always communicate with the Amazon Appstore client when it starts, even if you choose not to apply DRM.

The Amazon DRM is not tied to the key you used to sign your app. Amazon removes your signature and re-signs your app with an Amazon signature that is unique to you, does not change, and is the same for all apps in your account.

Providing Documentation for IP Use

If your app uses the IP of a third party, you will need to provide documentation of your license or IP rights to Amazon in order to list your app with the Amazon Appstore. This documentation must be either a confirmation letter from the IP rights holder with a formal signature or a copy of the applicable license agreement. Amazon will contact you during the app submission process to provide this documentation in a way that associates it with your app.

Screenshots of license agreements are not considered valid documentation for this requirement. Provide your documentation to Amazon in the form of a PDF file.

Amazon highlights apps through the Amazon Appstore, Fire tablets,, and through marketing vehicles such as email, Facebook, and Twitter. Examples of featured placements include "Highly Rated Apps and Games" and "Featured New Releases." Your app might be considered for these placements. Your app might also be considered for seasonal placements, such as summer travel, back to school, or holiday apps.

Amazon-approved marketing assets and brand, trademark, and marketing guidelines are here: Trademarks and Badges.

Transferring Your App to Another Vendor

If a situation arises (such as a company merger or spin-off) where you need to transfer one of your published apps to another developer account, you can do so with the help of Amazon support. See Contact Us.

Last updated: Oct 01, 2021