Skip to main content

​
builds

Manage builds, uploads, processing, and TestFlight distribution
The builds command manages uploads, processing state, TestFlight distribution, and build metadata in App Store Connect.

​
Usage

asc builds <subcommand> [flags]

​
Common subcommands

​
Upload builds

Upload an IPA or PKG to App Store Connect: 
asc builds upload --app APP_ID --ipa /path/to/MyApp.ipa
asc builds upload --app APP_ID --pkg /path/to/MyMacApp.pkg --version 1.0.0 --build-number 1

​
List builds

List builds for an app and filter by version, build number, or processing state: 
asc builds list --app APP_ID
asc builds list --app APP_ID --sort -uploadedDate
asc builds list --app APP_ID --version 1.2.3 --platform IOS
asc builds list --app APP_ID --processing-state PROCESSING

​
Inspect build details

Resolve a build directly by ID or by app context: 
asc builds info --build-id BUILD_ID
asc builds info --app APP_ID --latest
asc builds info --app APP_ID --build-number 42 --version 1.2.3 --platform IOS

​
Wait for processing

asc builds wait --build-id BUILD_ID
asc builds wait --app APP_ID --latest

​
Distribute to TestFlight groups

asc builds add-groups --app APP_ID --latest --group "External Testers"
asc builds add-groups --app APP_ID --latest --group "GROUP_ID" --submit --confirm
asc builds remove-groups --app APP_ID --latest --group "GROUP_ID" --confirm

​
Expire builds

asc builds expire --build-id BUILD_ID --confirm
asc builds expire-all --app APP_ID --older-than 90d --dry-run
asc builds expire-all --app APP_ID --keep-latest 5 --confirm

​
Common workflows

​
Upload and distribute the latest build

# Upload the build
asc builds upload --app 123456789 --ipa MyApp.ipa

# Wait until processing completes
asc builds wait --app 123456789 --latest

# Add the processed build to a TestFlight group
asc builds add-groups --app 123456789 --latest --group "External Testers"

​
Inspect the latest iOS build for a version

asc builds info --app 123456789 --latest --version 1.2.0 --platform IOS

​
Useful flags

​
--app
string
required
App Store Connect app ID, bundle ID, or exact app name
​
--ipa
string
Path to an .ipa file for iOS, tvOS, or visionOS uploads
​
--pkg
string
Path to a .pkg file for macOS uploads
​
--version
string
Filter or target a marketing version string (CFBundleShortVersionString)
​
--build-number
string
Filter or target a specific build number (CFBundleVersion)
​
--processing-state
string
Filter by processing state: VALID, PROCESSING, FAILED, INVALID, or all
​
--latest
boolean
Resolve the latest matching build in an app-scoped selector

TestFlight command

Manage TestFlight groups, testers, feedback, and review flows

TestFlight guide

Complete TestFlight distribution guide