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.

bash

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

JSON output:

json

{
  "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).

bash

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

bash

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

bash

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).

bash

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).

bash

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"]

Flag	Description
`--name`	App name (up to 30 characters)
`--subtitle`	Subtitle (up to 30 characters)
`--privacy-policy-url`	Main privacy policy URL
`--privacy-choices-url`	Privacy choices/opt-out URL
`--privacy-policy-text`	Inline privacy policy text

Delete Localization

Remove a locale entry permanently.

bash

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

CAEOAS Affordances

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

AppInfo:

json

{
  "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:

json

{
  "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:

json

{
  "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

bash

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

Type	Commands	Fields
`AppInfoLocalization`	`asc app-info-localizations *`	name, subtitle, privacyPolicyUrl, privacyChoicesUrl, privacyPolicyText
`AppStoreVersionLocalization`	`asc version-localizations *`	whatsNew, description, keywords, screenshots

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

asc-app-infos

NPX Install

Tags

SKILL.md Content

asc App Info & Localizations

List App Infos

Update App Info (Categories)

List App Categories

List Localizations

Create Localization

Update Localization

Delete Localization

CAEOAS Affordances

Resolve App ID

Typical Workflow

Two Localization Types