App Store Connect Help

Support / App Store Connect / Manage app information / Localize app information

Manage app information

Localize app information

After adding an app to your account, you can add languages and localized metadata on the App Information page. Learn more about supported languages and localizable properties.

For example, if you select English as the primary language for your app in App Store Connect, and it’s the only language you provide, your app metadata will appear in English in all App Store countries or regions. If you localize your app metadata in French, the French localization displays to users whose language setting is in French. The French localization also displays to users in countries or regions where the App Store supports French but not English. Users can search for your app using localized keywords in all countries or regions where the App Store supports French. If no localization matches a user's language setting, the next most relevant localization is used. In other countries or regions, your metadata displays in the primary language (English in this example).

Languages on the App Information page in App Store Connect are part of your app's metadata. This differs from adding languages to your app in Xcode when you localize your binary. Learn about localizing your app binary.

Learn how to manage the localization with the App Store Connect API.

Important: You can manage languages only when the app status is editable.

Required role: Account Holder, Admin, App Manager, or Marketing. View role permissions.

Add a language

When you add a language to your app, screenshots and the properties for the new language default to those of the primary language, except for the description and keywords. When you add a localization from the platform version section, it’s automatically added to the shared metadata under App Information and to other platforms.

  1. In Apps, select the app you want to view.

  2. On the top right, click the primary language to display the language pop-up menu.

    Screenshot of the iOS app version metadata page, with a pointer clicking a language listed in the top right opens the language menu.
  3. Scroll down the menu to Not Localized, hold the pointer over the language (and locale) you want to add, then click the add button (+) that appears to the right of the language.

    Screenshot of the language menu on the app platform detail page, which shows a highlighted language with a ‘+' button displays next to its name.
  4. Enter localized metadata—such as descriptions and keywords—for the platform, then click Save.

    View descriptions of these properties.

  5. To enter information that is shared across platforms, click App information.

  6. On the top right, click the primary language to display the language pop-up menu.

  7. Hold the pointer over the language (and locale) you want to add, then click the add button (+) that appears.

  8. Enter the app name and privacy policy URL for the language or locale, then on the top right, click Save.

    View descriptions of these properties.

Edit localizations

  1. In Apps, select the app you want to view.

  2. On the top right, choose the language from the pop-up menu.

  3. Edit the localized information, then click Save.

Delete a language

When you delete a language, countries or regions that display app information in that language revert to showing the information entered for the primary language.

  1. In Apps, select the app you want to view.

  2. On the top right, click the primary language to display the language pop-up menu.

  3. In the Localized section, hold the pointer over the language you want to delete and click the delete button (–).

    Screenshot of the language menu on the app platform detail page, which shows a highlighted language with a ‘-' button next to its name.

Change the primary language

You can change the primary language for an app. For a language to be selectable as the primary language:

  • You must have already added the language to a previous version.

  • App Review must approve the new language. If the language hasn’t been approved, submit a version with this localized metadata for approval. Then, select it as your primary language in a subsequent update.

  • You must have already uploaded screenshots in the language for all supported platforms that App Review already approved. If the screenshots for that localization are derived from another localization's screenshots, you must first manually add screenshots for that language and submit a version with these screenshots for approval. Then, change the primary language on a subsequent update. Learn more about adding screenshots and previews.

    Note: If your app has a custom product page configured, you must also have uploaded screenshots in the language for each custom product page.

  1. In Apps, select the app you want to view.

  2. In the sidebar, click App Information.

  3. In the Primary Language pop-up menu, choose the new primary language.

    Screenshot of the App Information page, where the General Information section displays the current primary language and a pop-up menu to choose a new primary language.
  4. On the top right, click Save.