No results found

Try a different or more specific query
Developer Console
Sign In
Sign In
Developer Console

Understanding Amazon Appstore Submission

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.com.

  • 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 Port: Develop your app from scratch or port an existing Android app for publishing in the Amazon Appstore. (See Port an Existing App to the Amazon Appstore.) Keep 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 Update 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.

Devices supporting only 64-bit apps

Some devices no longer support 32-bit apps, including any 32-bit apps currently available on Amazon Appstore. Customers attempting to download a 32-bit app on one of these devices will receive a notification alerting them that the app is not compatible with system requirements.

To make your app available to customers using one of these devices, add 64-bit (arm64-v8a) support to your app and submit an update using the Amazon Developer Portal. Please do not remove support for 32-bit (armeabi-v7a) while building your app, as it may impact current Amazon device selection.

Best Practices for 64-bit file submission

The Amazon Appstore accepts hybrid 32-bit/64-bit binary file 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 Your Binary File

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

Zip-aligning Your APK

This section applies only to APKs and not app bundles. 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 Console. See zipalign in the Android documentation for details.

If you submit an unaligned APK, the Developer Console 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 when you create an app in the Developer Console. The SHA-1, MD5, and SHA-256 hashes for your account are listed in the App Information tab in the Appstore Certificate Hashes section. Hashes are not visible for live apps. To view hashes for a live app, you need to edit the app or create a new version.

Upon request, Amazon can also provide the hashes for the Public Key exponent, Public Key modulus, and the Facebook hash key for Login with Facebook.

Amazon's Code Wrapper

When you submit your Android binary file to the Amazon Appstore, Amazon adds a wrapper to your code that includes metadata and an application signature. This code has the following purposes:

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

App Size Limitations

Uploaded Android binary files (AAB or APK) can be up to 2.5GB in size. Amazon recommends that you deploy small apps that download and install quickly. Then, upon first launch, your app can download additional resources and save them on the users' local file system. Expansion files or Binary blobs (.obb) are not supported by the Amazon Appstore. If you're submitting an APK, you must do so without .obb files. Make sure your app installs external resources in the proper path after downloading them at runtime.

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

Screen Resolutions

When creating 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 on the Other Information tab.

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)

If submitting an Android APK or app bundle, you can enable DRM in your app by using the DRM API from Amazon's Appstore SDK. For more information, see DRM Overview. If your app doesn't use the Appstore SDK, this section explains your options for adding automatically-applied Amazon DRM.

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 Allow Amazon to Apply DRM? field on the App Information tab, if you select Yes, Amazon DRM is automatically applied, and your app runs only if the signed-in user has an entitlement to your app. If you select No, Amazon doesn't automatically apply DRM and the app runs 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 always communicates with the Amazon Appstore client when it starts, even if you choose not to apply DRM.

Automatically-applied 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, Amazon.com, 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: May 31, 2023