Skip to main content

​
Overview

App Info commands manage version-specific metadata like descriptions, keywords, What’s New text, and other localization data.

​
Commands

​
asc app-info get

Get App Store version localization metadata.
​
--app
string
App Store Connect app ID (or ASC_APP_ID env variable)
​
--app-info
string
App Info ID (optional override)
​
--version-id
string
App Store version ID (optional override)
​
--version
string
App Store version string (optional)
​
--platform
string
Platform: IOS, MAC_OS, TV_OS, VISION_OS (required with --version)
​
--state
string
Filter by app store state(s), comma-separated
​
--locale
string
Filter by locale(s), comma-separated
​
--limit
integer
Maximum results per page (1-200)
​
--next
string
Fetch next page using a links.next URL
​
--paginate
boolean
default:"false"
Automatically fetch all pages
​
--include
string
Include related resources (comma-separated): ageRatingDeclaration, territoryAgeRatings, primaryCategory, primarySubcategoryOne, primarySubcategoryTwo, secondaryCategory, secondarySubcategoryOne, secondarySubcategoryTwo
Examples: 
asc app-info get --app "APP_ID"
asc app-info get --app "APP_ID" --version "1.2.3" --platform IOS
asc app-info get --version-id "VERSION_ID"
asc app-info get --app-info "APP_INFO_ID" --include "ageRatingDeclaration"
asc app-info get --app "APP_ID" --include "ageRatingDeclaration,territoryAgeRatings"
asc app-info get --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 app-info set

Create or update App Store version metadata.
​
--app
string
App Store Connect app ID (or ASC_APP_ID env variable)
​
--version-id
string
App Store version ID (optional override)
​
--version
string
App Store version string (optional)
​
--platform
string
Platform: IOS, MAC_OS, TV_OS, VISION_OS (required with --version)
​
--state
string
Filter by app store state(s), comma-separated
​
--locale
string
required
Locale (e.g., en-US)
​
--copy-from-locale
string
Copy submit-required fields (description, keywords, support-url) from this locale when missing
​
--description
string
App description
​
--keywords
string
Keywords (comma-separated)
​
--support-url
string
Support URL
​
--marketing-url
string
Marketing URL
​
--promotional-text
string
Promotional text
​
--whats-new
string
What’s New text
Examples: 
asc app-info set --app "APP_ID" --locale "en-US" --whats-new "Bug fixes"
asc app-info set --app "APP_ID" --locale "fr-FR" --copy-from-locale "en-US" --whats-new "Corrections"
asc app-info set --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 app-info get --app "123456789" --output table

​
Update What’s New text

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

​
Create a new locale by copying from existing

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

asc app-info get --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.