App Info Commands

Manage App Store version metadata

Overview

App Info commands manage version-specific metadata like descriptions, keywords, What’s New text, and other localization data. asc app-info ... still works as a deprecated compatibility alias, but the canonical commands live under asc apps info ....

Commands

`asc apps info view`

View app store version localization metadata.

string

App Store Connect app ID (or ASC_APP_ID env variable)

string

App Info ID (optional override; legacy --app-info also works)

string

App Store version ID (optional override)

string

App Store version string (optional)

string

Platform: IOS, MAC_OS, TV_OS, VISION_OS (required with --version)

string

Filter by app store state(s), comma-separated

string

Filter by locale(s), comma-separated

integer

Maximum results per page (1-200)

string

Fetch next page using a links.next URL

boolean

default:"false"

Automatically fetch all pages

string

Include related resources (comma-separated): ageRatingDeclaration, territoryAgeRatings, primaryCategory, primarySubcategoryOne, primarySubcategoryTwo, secondaryCategory, secondarySubcategoryOne, secondarySubcategoryTwo

Examples:

asc apps info view --app "APP_ID"
asc apps info view --app "APP_ID" --version "1.2.3" --platform IOS
asc apps info view --version-id "VERSION_ID"
asc apps info view --info-id "APP_INFO_ID" --include "ageRatingDeclaration"
asc apps info view --app "APP_ID" --include "ageRatingDeclaration,territoryAgeRatings"
asc apps info view --app "APP_ID" --locale "en-US" --output table

Response:

{
  "data": [
    {
      "id": "LOCALIZATION_ID",
      "type": "appStoreVersionLocalizations",
      "attributes": {
        "locale": "en-US",
        "description": "My app description",
        "keywords": "productivity, tools",
        "supportUrl": "https://example.com/support",
        "marketingUrl": "https://example.com",
        "promotionalText": "Try our new features!",
        "whatsNew": "Bug fixes and improvements"
      }
    }
  ]
}

`asc apps info edit`

Create or update App Store version metadata.

string

App Store Connect app ID (or ASC_APP_ID env variable)

string

App Store version ID (optional override)

string

App Store version string (optional)

string

Platform: IOS, MAC_OS, TV_OS, VISION_OS (required with --version)

string

Filter by app store state(s), comma-separated

string

required

Locale (e.g., en-US)

string

Copy submit-required fields (description, keywords, support-url) from this locale when missing

string

App description

string

Keywords (comma-separated)

string

Support URL

string

Marketing URL

string

Promotional text

string

What’s New text

Examples:

asc apps info edit --app "APP_ID" --locale "en-US" --whats-new "Bug fixes"
asc apps info edit --app "APP_ID" --locale "fr-FR" --copy-from-locale "en-US" --whats-new "Corrections"
asc apps info edit --app "APP_ID" --version "1.2.3" --platform IOS --locale "en-US" --description "New release"

Response:

{
  "data": {
    "id": "LOCALIZATION_ID",
    "type": "appStoreVersionLocalizations",
    "attributes": {
      "locale": "en-US",
      "description": "My app description",
      "keywords": "productivity, tools",
      "supportUrl": "https://example.com/support",
      "whatsNew": "Bug fixes"
    }
  }
}

Common Usage Patterns

Get metadata for the latest version

asc apps info view --app "123456789" --output table

Update What’s New text

asc apps info edit --app "123456789" --locale "en-US" --whats-new "New features and improvements"

Create a new locale by copying from existing

asc apps info edit --app "123456789" --locale "fr-FR" --copy-from-locale "en-US" --whats-new "Nouvelles fonctionnalités"

asc apps info view --app "123456789" --include "ageRatingDeclaration,territoryAgeRatings" --output json

Submit-Required Fields

The following fields are required for submission:

description - App description
keywords - Search keywords
supportUrl - Support URL

When creating a new locale, all submit-required fields must be provided. Use --copy-from-locale to automatically copy these fields from an existing locale.

Metadata Fields

Description

A description of your app, detailing features and functionality.

Maximum length: 4000 characters
Required for submission

Keywords

One or more keywords that describe your app. Keywords make App Store search results more accurate.

Separate keywords with English commas, Chinese commas, or a mix of both
Maximum 100 characters
Required for submission

Support URL

A URL with support information for your app.

Must be a valid URL
Required for submission

Marketing URL

A URL with marketing information about your app.

Must be a valid URL
Optional

Promotional Text

Promotional text lets you inform your App Store visitors of any current app features without requiring an updated submission.

Maximum 170 characters
Can be updated at any time
Optional

What’s New

Describe what’s new in this version of your app, such as new features, improvements, and bug fixes.

Maximum 4000 characters
Version-specific
Optional (but recommended)

Version Resolution

If multiple versions exist and no --version-id or --version is provided, the most recently created version is used.

Overview

App Management

TestFlight & Builds

Monetization & Analytics

Signing

Review & Release

Team & Access

Automation & Utilities

App info

App Info Commands

Overview

Commands

`asc apps info view`

`asc apps info edit`

Common Usage Patterns

Get metadata for the latest version

Update What’s New text

Create a new locale by copying from existing

Submit-Required Fields

Metadata Fields

Description

Keywords

Support URL

Marketing URL

Promotional Text

What’s New

Version Resolution

​App Info Commands

​Overview

​Commands

​asc apps info view

​asc apps info edit

​Common Usage Patterns

​Get metadata for the latest version

​Update What’s New text

​Create a new locale by copying from existing

​Get metadata with related resources

​Submit-Required Fields

​Metadata Fields

​Description

​Keywords

​Support URL

​Marketing URL

​Promotional Text

​What’s New

​Version Resolution

App Info Commands

Overview

Commands

`asc apps info view`

`asc apps info edit`

Common Usage Patterns

Get metadata for the latest version

Update What’s New text

Create a new locale by copying from existing

Get metadata with related resources

Submit-Required Fields

Metadata Fields

Description

Keywords

Support URL

Marketing URL

Promotional Text

What’s New

Version Resolution