Skip to main content

​
release

High-level App Store release staging workflows
The release command handles pre-submit App Store release staging. Use these paths deliberately:
  • asc release stage - deterministic pre-submit staging without submission
  • asc publish appstore --submit - canonical App Store upload + submit flow
  • Migrate to 1.0 if older automation still references release run

​
Usage

asc release <subcommand> [flags]

​
Subcommands

​
asc release stage

Run a deterministic pre-submit staging pipeline:
  1. Ensure or create the version
  2. Apply metadata/localizations or copy from another version
  3. Attach a selected build
  4. Run readiness checks
Stops before creating a review submission. 
asc release stage \
  --app "APP_ID" \
  --version "2.4.0" \
  --build "BUILD_ID" \
  --copy-metadata-from "2.3.2" \
  --dry-run

asc release stage \
  --app "APP_ID" \
  --version "2.4.0" \
  --build "BUILD_ID" \
  --metadata-dir "./metadata/version/2.4.0" \
  --confirm
Flags:
  • --app - App Store Connect app ID (or ASC_APP_ID)
  • --version - App Store version string
  • --build - Build ID to attach
  • --metadata-dir - Metadata directory to apply
  • --copy-metadata-from - Source version string to copy localization metadata from
  • --copy-fields - Comma-separated metadata fields to copy
  • --exclude-fields - Comma-separated metadata fields to exclude from copy
  • --checkpoint-file - Checkpoint path for resumable runs
  • --dry-run - Preview the deterministic plan without mutations
  • --confirm - Confirm staging mutations
  • --strict-validate - Treat readiness warnings as blocking
  • --platform - Platform: IOS, MAC_OS, TV_OS, VISION_OS
  • --timeout - Maximum time to run the staging pipeline

​
1.0 migration note

The old release run compatibility pipeline was removed in 1.0. Prefer:
  • asc release stage when you want deterministic pre-submit preparation
  • asc publish appstore --submit for the canonical App Store upload + submit path
After staging or submission: 
asc status --app "APP_ID"
asc validate --app "APP_ID" --version "2.4.0"
asc submit status --version-id "VERSION_ID"
asc submit cancel --version-id "VERSION_ID" --confirm

Publish command

Use publish appstore --submit for the canonical App Store shipping path

Status command

Monitor the resulting release pipeline state for an app

Submit command

Inspect or cancel lower-level review submission lifecycle state