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
- Localization options supported by Fire TV and tablets
- How marketplaces map to countries/regions and languages
- Fire device availability in marketplaces
- Coding practices for localizing your APK
- How to localize your app in the Appstore
- More information about localization
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:
- Dutch
- English (Australia)
- English (India)
- English (United States)
- French
- German
- Italian
- Japanese
- Polish
- Portuguese (Brazil)
- Portuguese (Portugal)
- Spanish
- Swedish
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:
- Deutsch (Deutschland)
- Deutsch (Österreich)
- English (Australia)
- English (Canada)
- English (India)
- English (United Kingdom)
- English (United States)
- Español (Mexico)
- Español (España)
- Français (Canada)
- Français (France)
- Italiano (Italia)
- Nederlands
- 日本語 (Japanese)
- Polskie
- Português (Brasil)
- Português (Portugal)
- Svenksa
Fire tablets allow users to set the following language preferences:
- Deutsch (Deutschland)
- English (United Kingdom)
- English (United States)
- Español
- Français
- Italiano
- 日本語 (Japanese)
- Português (Brasil)
- Simplified Chinese
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.)
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 Amazon.co.jp 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 Amazon.de 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.
A marketplace isn't always synonymous with a country. Marketplaces are language-specific. For example, the amazon.de marketplace (German) is also used for Austria and Switzerland; the amazon.fr marketplace (French) is also used for Belgium and Luxembourg.
| Global Area | Marketplace and Currency | Language | Countries Included |
|---|---|---|---|
| Americas | Amazon.com $USD |
English (US) | United States and other countries and territories |
| Amazon.ca $CAD |
English, French | Canada | |
| Amazon.mx $MXN |
Spanish | Mexico | |
| Amazon.com.br $BRL |
Portuguese | Brazil | |
| Europe | Amazon.co.uk £GBP |
English (UK) | United Kingdom, Gibraltar, Guernsey, Ireland, Isle of Man, Jersey |
| Amazon.de €EUR |
German | Germany, Austria, Liechtenstein, Switzerland, Luxembourg, the Netherlands, Finland | |
| Amazon.fr €EUR |
French | France metropolitan, Switzerland, Luxembourg, Monaco, Belgium | |
| Amazon.it €EUR |
Italian | Italy, Vatican City, San Marino, Switzerland | |
| Amazon.es €EUR |
Spanish | Spain, Andorra, Portugal | |
| Asia-Pacific | Amazon.co.jp ¥JPY |
Japanese | Japan |
| Amazon.in ₹INR |
English (India) | India | |
| Amazon.com.au $AUD |
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 device availability in marketplaces
Not all types of Fire TV or Fire tablet devices are available in all marketplaces.
During app submission, on the Target Your App screen, you select the countries and regions you want to target in the Availability section, and choose which devices you want to support in the Supported devices section. The Developer Console prevents you from targeting Fire devices that aren't supported in any of the countries or regions that you selected. If you targeted multiple countries, it's possible you picked a Fire device that's supported in some of your target countries but not others. In this case, the Appstore has logic to exclude displaying your app on that device in the marketplaces where it isn't supported.
Fire TV availability in marketplaces
The following table lists the availability of each Fire TV device by marketplace. Devices are listed by release date.
Fire tablet availability in marketplaces
The following table lists the availability of each Fire tablet device by marketplace. Devices are listed by release date.
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
- Setting prices for other marketplaces
- Providing localized descriptions
- Provide localized image assets
- Indicate your APK's supported languages
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 Target Your App screen. In the Availability section, click Only in selected countries and regions, then 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 Amazon.com account Country/Regions Settings.
Setting prices for other marketplaces
If you charge for your app, the Appstore Details screen 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 Amazon.com list price, so the auto-generated list prices for other marketplaces might end in oddly specific prices.
Providing localized descriptions
The Appstore Details screen allows you to describe your app title, description, feature bullets, and more, and acts as the storefront copy for your app in the Appstore. To provide localized descriptions of your app, click Add/Remove localization and select the language you want to add. The following dialog box to select the localizations appears:
After you select the localizations you want to support, the submission console adds tabs for each language. If you don't provide a localized description, the English (U.S.) description will be displayed instead.
Provide localized image assets
The Appstore Details screen 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 Add/Remove localization and select the language you want. Language tabs appears where you can upload your localized image assets. You don't have to wait for the assets to load before you switch to other tabs and select images to upload.
Indicate your APK's supported languages
The Upload Your App File screen provides a Language Support section where you can select languages your app supports.
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 Amazon.com website details page.
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:
- Selling Your Apps Internationally on Amazon
- International Localization
- Resources for International Locales
Last updated: Oct 02, 2023