Prepare your localized assets
Before touching App Store Connect, get your assets into a clean, predictable shape:
- Group screenshots into one set per locale, named with the App Store locale code.
- Confirm each image matches the required pixel dimensions for its device class.
- Keep slot order identical across locales so features line up.
- Have your localized metadata (title, subtitle, keywords, description, release notes) ready to go in the same pass.
Enable each locale first
App Store Connect will not accept assets for a language that is not yet added to the listing. This is the single most common reason an upload “succeeds” but the locale shows nothing.
- In App Store Connect, open the app’s listing and add each target language under the localization menu.
- Save so the locale exists before you push assets to it.
- Only then upload screenshots and metadata for that locale.
Choose an editable version
You can only change screenshots and metadata on a version that is in an editable state — typically a version you are preparing for submission, not one that is already live or in review.
- Pick the version you intend to submit, or create a new “prepare for submission” version.
- If you authenticate with an API key (Key ID, Issuer ID, Private Key), let the tool load your available versions and select the right one explicitly.
- Avoid editing a version locked in review — those changes will be rejected or silently dropped.
Publish and verify each locale
Upload is not the finish line. App Store Connect can accept a request and still skip individual locales, so verify per locale:
- Read the publish result for any skipped locales and the reason — usually a disabled locale or a non-editable version state.
- Open each locale in App Store Connect and confirm the screenshots appear in the right slots.
- Check that localized metadata saved without truncation.
- Preview the listing as a user in that market would see it.
Manual upload as a fallback
If you prefer not to publish through the API — or a locale needs a manual fix — download the localized bundle and manifest and upload through App Store Connect directly. The manifest maps each file to its locale and slot, so a manual upload stays as organized as an automated one.
Enable the locale, pick an editable version, then verify each language on its own. Those three steps prevent nearly every failed localized upload.