asc translate
Translate your app store metadata to multiple languages.
Usage
Syntaxbash
asc translate [options]
Options
| Option | Description |
|---|---|
--from, -f | Source locale (default: en-US) |
--to, -t | Target locale(s), comma-separated |
--all | Translate to all enabled locales |
--fields | Specific fields to translate |
--context | Additional context for translation |
--dry-run | Preview translations without saving |
--project, -p | Project ID (uses current if not specified) |
Examples
Translate to a single language
Single Languagebash
asc translate --from en-US --to es-ES# Output:# Translating from en-US to es-ES...# ✓ name: "My App" → "Mi Aplicación"# ✓ subtitle: "The best app ever" → "La mejor aplicación"# ✓ description: Translated (2,450 chars)# ✓ keywords: Translated (95 chars)# ✓ releaseNotes: Translated (320 chars)## Translation complete. 5 fields translated.
Translate to multiple languages
Multiple Languagesbash
asc translate --from en-US --to es-ES,fr-FR,de-DE,ja# Output:# Translating from en-US to 4 locales...## es-ES: ████████████████████ 100% (5/5 fields)# fr-FR: ████████████████████ 100% (5/5 fields)# de-DE: ████████████████████ 100% (5/5 fields)# ja: ████████████████████ 100% (5/5 fields)## Translation complete. 20 fields translated across 4 locales.
Translate to all enabled locales
All Localesbash
asc translate --from en-US --all# Output:# Translating from en-US to 12 enabled locales...## Processing... ████████████████████ 100%## Translation complete. 60 fields translated across 12 locales.
Translate specific fields
Specific Fieldsbash
asc translate --from en-US --to es-ES --fields description,releaseNotes# Output:# Translating 2 fields from en-US to es-ES...# ✓ description: Translated (2,450 chars)# ✓ releaseNotes: Translated (320 chars)## Translation complete. 2 fields translated.
Dry run preview
Dry Runbash
asc translate --from en-US --to es-ES --dry-run# Output:# DRY RUN - No changes will be saved## Translating from en-US to es-ES...## name:# en-US: "My App"# es-ES: "Mi Aplicación"## subtitle:# en-US: "The best app ever"# es-ES: "La mejor aplicación"## description:# en-US: (2,450 chars)# es-ES: (2,512 chars) [Preview truncated]## Run without --dry-run to save translations.
Available Fields
| Field | Description | Max Length |
|---|---|---|
name | App name | 30 chars |
subtitle | App subtitle | 30 chars |
description | Full description | 4,000 chars |
keywords | Search keywords | 100 chars |
releaseNotes | What's new | 4,000 chars |
promotionalText | Promotional text | 170 chars |
Pro Tip
Use the --context flag to provide app-specific context that helps improve translation quality, especially for industry-specific terms.