asc-metadata-sync

1# asc metadata sync
2 
3Use this skill to keep App Store metadata in sync with App Store Connect. Prefer the canonical `asc metadata` workflow for app-info and version localization fields. Use the lower-level `asc localizations` and `asc migrate` commands only when the user specifically needs `.strings` files or legacy fastlane-format metadata.
4 
5## Current canonical workflow
6 
7### 1. Pull canonical metadata
8 
9```bash
10asc metadata pull --app "APP_ID" --version "1.2.3" --platform IOS --dir "./metadata"
11```
12 
13If the app has multiple app-info records, resolve the app-info ID first and pass it explicitly:
14 
15```bash
16asc apps info list --app "APP_ID" --output table
17asc metadata pull --app "APP_ID" --app-info "APP_INFO_ID" --version "1.2.3" --platform IOS --dir "./metadata"
18```
19 
20### 2. Edit local files
21 
22Canonical files are written under:
23 
24- `metadata/app-info/<locale>.json` for app-level fields: `name`, `subtitle`, `privacyPolicyUrl`, `privacyChoicesUrl`, `privacyPolicyText`
25- `metadata/version/<version>/<locale>.json` for version fields: `description`, `keywords`, `marketingUrl`, `promotionalText`, `supportUrl`, `whatsNew`
26 
27Copyright is not a localization field. Manage it with:
28 
29```bash
30asc versions update --version-id "VERSION_ID" --copyright "2026 Your Company"
31```
32 
33### 3. Validate before upload
34 
35```bash
36asc metadata validate --dir "./metadata" --output table
37```
38 
39For subscription apps, include the extra Terms of Use / EULA heuristic:
40 
41```bash
42…