Skip to main content

testflight

Manage TestFlight groups, testers, feedback, crashes, and review workflows
The testflight command groups the higher-level TestFlight resources that sit around builds: groups, testers, feedback, crash submissions, review details, notifications, and exported config.

Usage

asc testflight <subcommand> [flags]

Key subcommands

Groups

Create and manage internal or external beta groups:
asc testflight groups list --app APP_ID
asc testflight groups create --app APP_ID --name "Beta Testers"
asc testflight groups create --app APP_ID --name "Internal Testers" --internal
asc testflight groups view --id GROUP_ID

Testers

List testers, add new testers, and manage their group/build access:
asc testflight testers list --app APP_ID
asc testflight testers add --app APP_ID --email user@example.com --group "Beta"
asc testflight testers view --id TESTER_ID
asc testflight testers add-groups --id TESTER_ID --group GROUP_ID

Feedback and crashes

Inspect beta feedback submissions and crash reports:
asc testflight feedback list --app APP_ID
asc testflight feedback view --submission-id SUBMISSION_ID
asc testflight crashes list --app APP_ID
asc testflight crashes log --submission-id SUBMISSION_ID

Review and distribution

Manage TestFlight review details and distribution settings:
asc testflight review view --app APP_ID
asc testflight distribution view --build-id BUILD_ID
asc testflight notifications send --build-id BUILD_ID

Metrics and config

asc testflight metrics group-testers --group GROUP_ID
asc testflight metrics app-testers --app APP_ID
asc testflight config export --app APP_ID --output ./testflight.yaml

Common workflows

Create a beta group and add testers

# Create a new beta group
asc testflight groups create \
  --app 123456789 \
  --name "External Testers"

# Add testers to the group
asc testflight testers add \
  --app 123456789 \
  --email tester@example.com \
  --group "External Testers"

Review incoming beta feedback

asc testflight feedback list --app 123456789 --output table
asc testflight crashes list --app 123456789 --sort -createdDate --limit 10

Builds command

Manage uploads, processing, and build distribution

TestFlight guide

Complete TestFlight distribution guide