asc App Info & Localizations

Manage app-level metadata (name, subtitle, privacy policy URLs, categories) via the asc CLI.

Note: This is distinct from version-level metadata (asc version-localizations) which handles "What's New", description, and keywords. App info localizations hold the persistent app name and subtitle.

List App Infos

Each app has one AppInfo record (rarely more). Get the AppInfo ID needed for subsequent commands.

asc app-infos list --app-id <APP_ID> [--pretty]

JSON output:

{
  "data": [
    {
      "id": "info-abc123",
      "appId": "6746148194",
      "affordances": {
        "getAgeRating":      "asc age-rating get --app-info-id info-abc123",
        "listAppInfos":      "asc app-infos list --app-id 6746148194",
        "listLocalizations": "asc app-info-localizations list --app-info-id info-abc123",
        "updateCategories":  "asc app-infos update --app-info-id info-abc123"
      }
    }
  ]
}

Update App Info (Categories)

Set primary and/or secondary category. All flags are optional (PATCH semantics).

asc app-infos update --app-info-id <APP_INFO_ID> \
  [--primary-category GAMES] \
  [--primary-subcategory-one GAMES_ACTION] \
  [--secondary-category UTILITIES]

List App Categories

Browse all App Store category IDs (required for app-infos update).

asc app-categories list [--platform IOS|MAC_OS|TV_OS] [--output table]

Sample IDs: GAMES, GAMES_ACTION, GAMES_PUZZLE, GAMES_ADVENTURE, BUSINESS, UTILITIES, EDUCATION, HEALTH_AND_FITNESS, ENTERTAINMENT, SOCIAL_NETWORKING, PRODUCTIVITY, FINANCE, MUSIC, TRAVEL, SPORTS

Subcategories follow the pattern PARENT_SUBTYPE (e.g. GAMES_ACTION is under GAMES). The API does not return a parentId field.

List Localizations

asc app-info-localizations list --app-info-id <APP_INFO_ID> [--output table]

Table output:

ID        Locale    Name            Subtitle
--------  --------  --------------  --------------------
loc-001   en-US     My App          Do things faster
loc-002   zh-Hans   我的应用         更快地完成任务

Create Localization

Create a new locale entry. --name is required (up to 30 characters).

asc app-info-localizations create \
  --app-info-id <APP_INFO_ID> \
  --locale zh-Hans \
  --name "我的应用"

Common locales: en-US, zh-Hans, zh-Hant, ja, ko, de, fr

Update Localization

All fields are optional — only provided fields are changed (PATCH semantics).

asc app-info-localizations update \
  --localization-id <LOCALIZATION_ID> \
  [--name "New App Name"] \
  [--subtitle "Do things faster"] \
  [--privacy-policy-url "https://example.com/privacy"] \
  [--privacy-choices-url "https://example.com/choices"] \
  [--privacy-policy-text "Our privacy policy text"]

Delete Localization

Remove a locale entry permanently.

asc app-info-localizations delete --localization-id <LOCALIZATION_ID>

CAEOAS Affordances

Every response includes ready-to-run follow-up commands:

AppInfo:

{
  "affordances": {
    "getAgeRating":      "asc age-rating get --app-info-id <ID>",
    "listAppInfos":      "asc app-infos list --app-id <APP_ID>",
    "listLocalizations": "asc app-info-localizations list --app-info-id <ID>",
    "updateCategories":  "asc app-infos update --app-info-id <ID>"
  }
}

AppInfoLocalization:

{
  "affordances": {
    "delete":             "asc app-info-localizations delete --localization-id <ID>",
    "listLocalizations":  "asc app-info-localizations list --app-info-id <APP_INFO_ID>",
    "updateLocalization": "asc app-info-localizations update --localization-id <ID>"
  }
}

AppCategory:

{
  "affordances": {
    "listCategories": "asc app-categories list"
  }
}

Resolve App ID

See project-context.md — check .asc/project.json before asking the user or running asc apps list.

Typical Workflow

APP_ID=$(cat .asc/project.json 2>/dev/null | jq -r '.appId // empty')
# If empty: ask user or run `asc apps list | jq -r '.data[0].id'`

# 1. Get the AppInfo ID
APP_INFO_ID=$(asc app-infos list --app-id "$APP_ID" | jq -r '.data[0].id')

# 2. See existing localizations
asc app-info-localizations list --app-info-id "$APP_INFO_ID" --output table

# 3a. Update an existing locale
LOC_ID=$(asc app-info-localizations list --app-info-id "$APP_INFO_ID" \
  | jq -r '.data[] | select(.locale == "en-US") | .id')
asc app-info-localizations update \
  --localization-id "$LOC_ID" \
  --name "My App" \
  --subtitle "Do things faster" \
  --privacy-policy-url "https://example.com/privacy"

# 3b. Add a new locale
asc app-info-localizations create \
  --app-info-id "$APP_INFO_ID" \
  --locale zh-Hans \
  --name "我的应用"

# 3c. Remove an unwanted locale
asc app-info-localizations delete --localization-id <LOCALIZATION_ID>

# 4. Set app category
asc app-categories list --platform IOS --output table
asc app-infos update \
  --app-info-id "$APP_INFO_ID" \
  --primary-category GAMES \
  --primary-subcategory-one GAMES_ACTION

# 5. Check age rating (navigate via affordance)
asc age-rating get --app-info-id "$APP_INFO_ID"

Two Localization Types

App info localizations are persistent across app versions. Version localizations are per-release.