Developer Console
Thank you for your visit. This page is only available in English at this time.

Distribute Your App Internationally

When you create a new app, it is set to be available in all marketplaces by default. If desired (and especially if your APK supports localization), you can localize the store listing (the descriptions and image assets) of your app in other marketplaces to provide a better experience in those marketplaces.

Localization Options Supported by the Appstore

When distributing your app internationally, you can decide which countries and regions to target with a localized app experience in the Appstore. The "Appstore" refers to your app's store listing on the website or in the device's store display.

Users who view your app in an Amazon marketplace that corresponds with one of these languages will see the localized version of your app's description and image assets. If the user's country or region is outside of a supported Amazon marketplace, English is used by default.

The Appstore supports the following localizations for store listings:

  • German
  • English (Australia)
  • English (U.S.)
  • English (India)
  • Spanish
  • French
  • Italian
  • Japanese
  • Portuguese (Brazil)

Note that these localizations refer to your app's storefront page in the Appstore (where your app is presented to users to download), not localizations that your APK can support on actual devices. You can localize your APK is as many languages as you want. When users install the APK on their device, the language strings that get used in your APK depend on the language settings of the user's device.

Localization Options Supported by Fire TV and Tablets

Fire TV allows users to set the following language preferences on the device:

  • English (United States)
  • English (United Kingdom)
  • English (Canada)
  • English (Australia)
  • English (India)
  • Español (Mexico)
  • Español (España)
  • Français (Canada)
  • Français (France)
  • Deutsch (Deutschland)
  • Deutsch (Österreich)
  • Italiano (Italia)
  • Português (Brasil)
  • 日本語 (Japanese)

Fire tablets allow users to set the following language preferences:

  • Deutsch (Deutschland)
  • English (United States)
  • English (United Kingdom)
  • Español
  • Français
  • Italiano
  • Simplified Chinese
  • Português (Brasil)
  • 日本語 (Japanese)

Setting these languages on the device switches the UI strings for Fire TV or Fire Tablet to that language. If your APK supports that language, your app will load those language strings as well. (If a user switches to Japanese but your app supports only English, English strings will be displayed in your app while Japanese strings are displayed in Fire TV's general UI.)

Example Localization for an App in Appstore and APK

Suppose that in addition to supporting English, you localize your APK (following standard Android localization practices) to also support Japanese and German. You also localize your app's descriptions and image assets (referred to as your app's "metadata" because they're outside your app) in the Appstore with Japanese and German localizations.

When users in Japan download your app (from the marketplace), they see the Japanese descriptions and image assets in the Appstore. Then when users load the app on a Fire device, they see the Japanese strings in your app's UI by default (assuming their device's language is set to Japanese).

When users in Germany download your app (from the marketplace), they see the German descriptions and image assets in the Appstore, but when they load your app, they see the German strings in your app's UI by default (assuming their device's language is set to German).

In each case, you have just one app in the Appstore and one APK that you've uploaded. (You don't need separate apps or separate APKs for the different localizations and marketplaces.) All metrics for your app (ratings, downloads, etc.) are rolled up into a unified display.

How Marketplaces Map to Countries/Regions and Languages

The following image shows the various Amazon marketplaces and the countries/regions and languages they're associated with.

Amazon's marketplaces and the geographical regions they include
Amazon's marketplaces and the geographical regions they include

A marketplace isn't always synonymous with a country. Marketplaces are language-specific. For example, the marketplace (German) is also used for Austria and Switzerland; the marketplace (French) is also used for Belgium and Luxembourg.

Marketplaces, country/regions, and languages
Global Area Marketplace Language Countries Included
Americas English (US) United States and other countries and territories English, French Canada Spanish Mexico Portuguese Brazil
Europe English (UK) United Kingdom, Gibraltar, Guernsey, Ireland, Isle of Man, Jersey German Germany, Austria, Liechtenstein, Switzerland, Luxembourg French France metropolitan, Switzerland, Luxembourg, Monaco, Belgium Italian Italy, Vatican City, San Marino, Switzerland Spanish Spain, Andorra
Asia-Pacific Japanese Japan English (India) India English (Australian) Australia, New Zealand, Christmas Island, Cocos (Keeling) Islands, Heard & McDonald Islands, Norfolk Island, Cook Islands, Niue, Tokelau

For additional reference, see Countries & Territories Eligible to Shop for Apps in Other Amazon Marketplaces.

Fire TV Availability in Marketplaces

Not all types of Fire TV devices are available in all marketplaces. The following table lists the available of each Fire TV device by marketplace. Devices are listed by release date.

Device Type Fire TV Device Marketplaces
Smart TV Toshiba 4K Far-field UHD - Fire TV (2021)
Stick Fire TV Stick 4K Max - 1st Gen (2021)
Automotive Stellantis (Jeep) - Wagoneer/Grand Wagoneer
Smart TV Fire TV Omni Series (2021)
Smart TV Fire TV 4-Series (2021)
Smart TV Toshiba 4K UHD - Fire TV (2021)
Smart TV AmazonBasics 4K - Fire TV (2020)
Smart TV AmazonBasics HD/FHD - Fire TV (2020)
Smart TV Technika 4K - Fire TV (2020)
Smart TV JVC 2K - Fire TV (2020)
Smart TV Onida HD/FHD - Fire TV (2020) [Available in two sizes]
Smart TV ok 4K - Fire TV (2020)
Stick Fire TV Stick - 3rd Gen (2020)
Stick Fire TV Stick Lite - 1st Gen (2020)
Smart TV Toshiba 4K UHD - Fire TV (2020)
Smart TV Insignia 4K UHD - Fire TV (2020)
Stick Fire TV Stick - 2nd Gen (2016-2019)
Smart TV Toshiba HD - Fire TV (2018-2020)
Smart TV Insignia HD - Fire TV (2018-2020)
Smart TV Toshiba 4K - Fire TV (2018-2019)
Smart TV Onida HD - Fire TV (2019)
Cube Fire TV Cube - 2nd Gen (2019)
Smart TV Grundig OLED 4K - Fire TV (2019)
Smart TV Grundig Vision 7, 4K - Fire TV (2019)
Smart TV JVC 4K - Fire TV (2019)
Soundbar Nebula Soundbar - Fire TV Edition (2019)
Smart TV Grundig Vision 6 HD - Fire TV (2019)
Smart TV Insignia 4K - Fire TV (2018)
Cube Fire TV Cube - 1st Gen (2018)
Stick Fire TV Stick 4K - 1st Gen (2018)
Stick Fire TV Stick - Basic Edition (2017)
Smart TV Element 4K - Fire TV (2017)
Set-top box Fire TV - 3rd Gen (2017)
Set-top box Fire TV - 2nd Gen (2015)
Stick Fire TV Stick - 1st Gen (2014)
Set-top box Fire TV - 1st Gen (2014)
Soundbar TCL Soundbar with Built-in Subwoofer - Fire TV Edition (2019)
Smart TV Toshiba V35 Series LED FHD/HD - Fire TV (2021)

For many countries, Fire TV Stick Basic Edition is the only version of Fire TV available.

During the app submission process, even if you indicate support (in the Device Support section of the APK Files tab) for a Fire TV device not available in a particular country or region, the Appstore's display logic is smart enough to exclude any devices not available with your app in that marketplace.

Coding Practices for Localizing Your APK

For details on coding your app to support various localizations, follow standard Android localization practices as outlined in the following topics:

How to Localize Your App in the Appstore

When you submit your app into the Appstore, the Developer Console allows you to provide localized descriptions and image assets for your app. Note the following options as you submit your app. Each option is explained in the sections below.

Restricting app availability

By default, when you submit your app, it becomes available in every marketplace. But if you only want your app to be available, say, in Japan (perhaps because your app only supports Japanese), you can select Japan as the only available country for your app.

You can restrict the availability of your app to specific countries and regions on the Availability & Pricing tab. Next to Where would you like this app to be available?, click Only in selected countries and regions and select the countries and regions where you want your app to be available.

Your customers can only see your app if they have selected the applicable Country of Residence (COR) in their account Country/Regions Settings.

Setting prices for other marketplaces

If you charge for your app, the Availability & Pricing tab also lets you set prices in each marketplace. By default, Amazon will calculate the list price used to calculate royalties for sales of your app in foreign currencies based on recent exchange rates. However, you can change the list prices as desired.

For example, an app that sells for $2.99 in USD becomes ₤1.96 Pounds in Great Britain.

You might want to change the list prices to end in .99, .49, or other common values in each marketplace. The Appstore calculates these other list prices proportional to the list price, so the auto-generated list prices for other marketplaces might end in oddly specific prices.

Providing localized descriptions

The Descriptions tab allows you to describe your app title, description, feature bullets, etc., and acts as the storefront copy for your app in the Appstore. To provide localized descriptions of your app, click the Add localized descriptions button and select the language you want. You'll see the following dialog box to select the localizations:

Supported localizations
Supported localizations for the Appstore

After you select the localizations you want to support, the submission console adds tabs for each language. Note that if you don't provide a localized description, the English (U.S.) description will be displayed instead.

Provide localized image assets

The Images & Multimedia tab lets you upload your app logo, background image, screenshots, and other image assets that are used to promote your app within the Appstore.

To provide localized image assets, click the Add Localized Media button and select the language you want. Language tabs will appear so you can upload you localized image assets. Note that you don't have to wait for the assets to load before you switch to other tabs and select images to upload. (Learn more about asynchronous uploading.)

Indicate your APK's supported languages

The APK Files tab provides a "Language Support" section with various language check boxes you can select.

Language Support check boxes on APK Files tab
Language Support check boxes on APK Files tab

This "Language Support" section adds these supported languages to the device's app details page in the Appstore, letting users know which languages your app supports. The section does not impact any Appstore logic in regards to localization. (The device app details page refers to the app details page that appears on a mobile device, such as a Fire TV or Fire Tablet, rather than the website details page.)

Note that the Language Support selection here doesn't influence whether your app becomes available in other, localized Appstore marketplaces. Any localization interfaces in your APK must be handled by your APK itself, not through settings in the Appstore submission process.

For example, if you select Tagalog as a supported language in your app, on the device's Appstore details page, a Supported Languages section appears letting users know that Tagalog is supported in your app. When a user launches your app, whether Tagalog appears as the default language in your app depends on how you've coded your APK and whether the user's device settings have selected Tagalog as a preferred language. The Appstore won't deliver a Tagalog localized experience to users by default because Tagalog is not a language preference option for Fire TV or Fire Tablet. But you might provide a way within your app for users to select such a language.

More Information About Localization

For more information on localization, see these posts:

Last updated: May 10, 2021