asc push

Push metadata to App Store Connect and Google Play Console.

Usage

Syntaxbash
asc push [store] [options]

Options

OptionDescription
appstorePush to App Store Connect only
playstorePush to Google Play Console only
--locales, -lSpecific locales to push
--fieldsSpecific fields to push
--screenshotsAlso push screenshots
--dry-runPreview changes without pushing
--forceSkip validation and confirmation
--project, -pProject ID (uses current if not specified)

Examples

Push to both stores

Both Storesbash
asc push
# Output:
# Validating metadata...
# ✓ All fields within character limits
# ✓ Required fields present
#
# Pushing to stores...
#
# App Store Connect:
# ✓ en-US: name, subtitle, description, keywords, releaseNotes
# ✓ es-ES: name, subtitle, description, keywords, releaseNotes
# ✓ fr-FR: name, subtitle, description, keywords, releaseNotes
#
# Google Play Console:
# ✓ en-US: title, shortDescription, fullDescription
# ✓ es-ES: title, shortDescription, fullDescription
# ✓ fr-FR: title, shortDescription, fullDescription
#
# Push complete. 6 locales updated on 2 stores.

Push to App Store only

App Store Onlybash
asc push appstore
# Output:
# Validating metadata for App Store...
# ✓ All fields within character limits
# ✓ Required fields present
#
# Pushing to App Store Connect...
# ✓ en-US: 5 fields updated
# ✓ es-ES: 5 fields updated
# ✓ fr-FR: 5 fields updated
#
# Push complete. 3 locales updated.

Push specific locales and fields

Specific Fieldsbash
asc push --locales en-US --fields description,releaseNotes
# Output:
# Pushing description, releaseNotes for en-US...
#
# App Store Connect:
# ✓ en-US: description, releaseNotes
#
# Google Play Console:
# ✓ en-US: fullDescription
#
# Push complete. 2 fields updated on 2 stores.

Dry run preview

Dry Runbash
asc push --dry-run
# Output:
# DRY RUN - No changes will be pushed
#
# Changes to be pushed:
#
# App Store Connect:
# en-US:
# - description: 2,450 chars (changed)
# - releaseNotes: 320 chars (new)
# es-ES:
# - description: 2,512 chars (changed)
# - releaseNotes: 335 chars (new)
#
# Google Play Console:
# en-US:
# - fullDescription: 2,450 chars (changed)
# es-ES:
# - fullDescription: 2,512 chars (changed)
#
# Run without --dry-run to push changes.

Push with screenshots

With Screenshotsbash
asc push --screenshots
# Output:
# Validating metadata and screenshots...
# ✓ All fields within character limits
# ✓ Screenshot dimensions valid
#
# Pushing to stores...
#
# App Store Connect:
# ✓ en-US: 5 fields, 10 screenshots
# ✓ es-ES: 5 fields, 10 screenshots
#
# Google Play Console:
# ✓ en-US: 3 fields, 8 screenshots
# ✓ es-ES: 3 fields, 8 screenshots
#
# Push complete. 16 fields, 36 screenshots updated.

Validation Errors

If validation fails, push will show the errors:

Validation Errorsbash
asc push
# Output:
# Validating metadata...
# ✗ Validation failed:
#
# en-US:
# - description: Exceeds 4,000 character limit (4,127 chars)
# - keywords: Missing required field
#
# es-ES:
# - name: Exceeds 30 character limit (35 chars)
#
# Fix these issues and try again.