# Translate app metadata

Load your App Store Connect metadata, translate from its source language, and review each localization before updating it.

Source: https://asoengine.app/docs/metadata-translator/

By Maicol Cabreja. Reviewed 2026-10-19.

## Connect and choose your version

1. Connect App Store Connect and configure your OpenAI key in Settings → AI Model.

2. Open Metadata Translator and choose your own app using the toolbar app picker.

3. Choose a platform, version, and metadata field in the toolbar. The version menu also shows its status.

4. Wait for metadata to load. The localization marked Source · App Store Connect is the translation source—not necessarily English.

[Connect App Store Connect](https://asoengine.app/docs/app-store-connect/)

[Set up OpenAI](https://asoengine.app/docs/openai/)

## Add languages and translate

1. Choose Add Languages to add the supported App Store languages that are missing. The action is disabled once all are present or the selected version cannot be edited.

2. Review the source text. Choose Translate all to translate the selected field into the target languages, or Translate on one target localization.

3. Review the generated text, character counts, names, and product terminology. Shorten any over-limit values before publishing.

4. If some languages fail, inspect their errors and use Retry Failed Languages when offered.

Note: Translation makes drafts; it does not automatically publish them. URL fields use Copy to all rather than AI translation.

## Update App Store Connect

Use Update on a localization to send the selected metadata field for that language. Update All includes the source localization as well as the targets; review every value first.

Progress and individual failures show what completed. An update changes App Store Connect metadata; it does not submit your app for review or bypass Apple’s publishing requirements.

Note: Switching metadata fields with unsaved edits asks you to discard them or cancel. Refresh can keep drafts or discard them and reload App Store Connect values. Save important work before leaving the app.

## Read-only versions and new versions

A read-only version can be viewed, but editing and update actions are disabled. Open the version menu and choose Create New Version… when available. Use a valid version number higher than the existing version; the app and Apple validate the request.

Check the new version’s fields before translating or updating. Creating a version is separate from uploading a build and submitting it for review.

[Read-only version troubleshooting](https://asoengine.app/docs/troubleshooting/#read-only-versions)