Help & FAQ
Getting Started
Q: How do I set up my API credentials?
A: Click on the ‘API Keys’ button in the toolbar, then follow the instructions on the setup screen. Click on any credential label (Issuer ID, Key ID, or Private Key) to open the App Store Connect API page where you can generate your keys. You’ll need an Admin or App Manager role in App Store Connect.
Q: What permissions do I need?
A: You need an Admin or App Manager role in App Store Connect to generate API keys and manage app metadata. If you don’t have these permissions, contact your App Store Connect account administrator.
Working with Apps and Versions
Q: Why can’t I edit a version?A: Versions that are ‘Live on the App Store’, or ‘Waiting for review’, cannot be edited. Only versions in ‘Preparing for submission’ states can be modified. Create a new version if you need to make changes to a live version.
Q: What’s the difference between App Names, Descriptions, and What’s New?A: App Names and Subtitles are app-level metadata that apply to your entire app across all versions. Descriptions and What’s New are version-specific and can be different for each version of your app.
Languages
Q: How do I add a new language?
A: Click on the language count badge in the toolbar to open the ‘Manage Languages’ window. Check the languages you want to add, then click ‘Confirm’. Note: You cannot add languages to versions that are live or submitted for review.
Q: Can I remove a language?
A: Yes. Open the ‘Manage Languages’ window and uncheck any languages you want to remove, then click ‘Confirm’. This will remove the language from App Store Connect.
Q: What is the Default Language?
A: The default language is simply the language that appears at the top of the list in the metadata editor. You can set it using the ‘Default’ picker in the toolbar.
Import & Export
Q: How do I export my metadata?
A: Click the ‘Export/Import’ button in the toolbar. Select ‘Export’ mode, choose which languages and sections (Descriptions and/or What’s New) you want to export, then click ‘Export’. The app will generate a .xcstrings file that you can share with translators.
Q: How do I import translations?
A: Click the ‘Export/Import’ button and select ‘Import’ mode. Choose which languages and sections to import, then click ‘Import’ and select your .xcstrings file. The app will update your App Store Connect metadata with the imported translations.
Q: What format does the export use?
A: Exports use the .xcstrings format, which is a JSON-based localization format used by Xcode. This format is compatible with translation tools and can be edited in any text editor.
Uploading Changes
Q: How do I upload my changes?
A: After editing your metadata, click the ‘Upload’ button in the toolbar. A window will appear where you can select which languages to upload. Select the languages you want to update, then click ‘Upload’.
Q: What happens if I leave fields empty?
A: If you try to upload with empty fields, the app will warn you and ask if you want to save anyway. You can choose to proceed or cancel and fill in the missing fields.