Documentation
Everything you need to know about automating App Store localization
🚀 Quick Start
- 1.Install Extension: Add to Chrome from Web Store
- 2.Prepare JSON: Download English from App Store or use our API
- 3.Navigate: General → App Information in App Store Connect
- 4.Load JSON: Click "Load JSON File" in extension
- 5.Click Run: Extension fills all 47 locales automatically
📊 High-Level Workflow
How the Workflow Works
Step 1: JSON File - Your localization data source
- Contains all 47 iOS App Store locales
- Simple structure:
{ "locale": { "name": "...", "subtitle": "..." } } - Each locale has exactly 2 fields: name (max 30 chars) and subtitle (max 30 chars)
- Generate via our API or translate using external tools
Step 2: Chrome Extension - Your automation assistant
- Loads JSON file with one click
- Stores data persistently - load once, use forever
- Auto-detects current locale on App Store Connect page
- Shows name & subtitle for current locale
- Editable fields - review and modify before filling
- One-click Run button: Fill → Save → Next locale (automated loop)
Step 3: App Store Connect - Target destination
- Extension fills Name and Subtitle fields automatically
- Clicks Save button for you
- Switches to next locale automatically
- Repeats until all 47 locales are processed
- Total time: 10-15 minutes (vs 2-3 hours manually)
🔄 Detailed Data Flow
Complete Process Breakdown
📥 Step 1: Prepare Your JSON File
- Download current English (en-US) metadata from App Store Connect
- Use our translation tools or external services to translate name & subtitle to 46+ languages
- Format:
AppStore-App-Information.json - Contains all 47 locales with name and subtitle for each
🌐 Step 2: Navigate to App Store Connect
- Open your app in App Store Connect
- In left sidebar, find General section
- Click App Information under General
- Select any localization from dropdown (e.g., en-US)
- Extension auto-detects you're on the correct page
🧩 Step 3: Use the Extension
- Click extension icon in Chrome toolbar (🧩 puzzle piece)
- Extension popup opens showing current locale
- Click "Load JSON File" button
- Select your
AppStore-App-Information.jsonfile - Extension loads and stores data (no need to reload next time)
⚡ Step 4: Automate Localization
- Extension shows name & subtitle for current locale (e.g., "English Verbs..." for en-US)
- Review and edit if needed (fields are editable)
- Click big purple "Run" button
- Extension automatically:
- Fills Name field
- Fills Subtitle field
- Clicks Save button
- Switches to next locale
- Repeat for all 47 locales (fully automated)
🎉 Step 5: All Locales Completed
- Extension processes all 47 locales in 10-15 minutes
- Every locale now has name and subtitle filled
- No manual copy-pasting required
- Consistent translations across all languages
- Save 2-3 hours of tedious work per app update!
✨ Key Features
📝 Editable Fields
Review and modify translations before filling. Not happy with a translation? Edit it right in the extension.
- • 30 character limit enforced
- • Reset button (↺) to restore original
- • Changes apply immediately on Fill
💾 Persistent Storage
Load JSON once, it stays forever. Extension remembers your data across sessions.
- • Uses chrome.storage.local
- • No need to reload file
- • Works offline after initial load
⚠️ Smart Fallback
Missing translation for a locale? Extension automatically uses English with clear warning.
- • Yellow icon (ⓘ) with detailed tooltip
- • Orange border on fields
- • Can edit and use anyway
📍 Page Detection
Extension automatically detects if you're on the right page. Shows guidance if not.
- • Auto-detects App Information page
- • Shows instruction overlay if wrong page
- • 3-step guide to navigate correctly
📄 JSON File Format
The extension expects a simple JSON structure with locale codes as keys:
{
"en-US": {
"name": "English Verbs: Right Way to B2",
"subtitle": "irregular verbs pictures & quiz"
},
"ru": {
"name": "Англ. глаголы: учим A2 B1 B2",
"subtitle": "Неправильные глаголы: тесты"
},
"de-DE": {
"name": "Englische Verben: Weg zum B2",
"subtitle": "Unregelmäßige Verben: Bilder"
},
"es-ES": {
"name": "Verbos inglés: Domina hasta B2",
"subtitle": "verbos irregulares: imágenes"
}
// ... 43 more locales
}💡 Tip: Click "Get Demo File" in the extension to download a template JSON file you can edit.
🌍 Supported Locales
Extension supports all 47 App Store Connect localizations:
❓ Frequently Asked Questions
Do I need API keys or authentication?
No! The extension works directly in your browser. You just need to be logged into App Store Connect. No API keys, no configuration, no setup required.
How do I get translated name and subtitle for all languages?
Use our translation scripts (open source) or our API endpoint at /api/generate-localization. Provide your English name, subtitle, and description - get back JSON with all 47 locales translated.
Can I edit translations before filling?
Yes! All fields are editable. Review each translation, make changes if needed, then click Fill. Your edits will be used instead of the JSON value.
What if a locale is missing from my JSON?
Extension automatically falls back to English (en-US) with a clear warning. You'll see a yellow icon (ⓘ) and orange borders. You can still fill with English or edit the value before filling.
How long does it take to process all locales?
Approximately 10-15 minutes for all 47 locales. The Run button does Fill → Save → Next automatically with a small delay between locales to ensure saves complete. Much faster than the 2-3 hours of manual work!
Ready to Get Started?
Install the extension and automate your localization today
🚀 Add to Chrome