> ## Documentation Index
> Fetch the complete documentation index at: https://docs.asccli.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Testflight

# TestFlight Distribution

> Distribute builds to beta testers using TestFlight

Manage your TestFlight beta testing program end-to-end, from organizing beta groups to collecting feedback from testers.

## Overview

TestFlight allows you to distribute pre-release builds to internal and external testers. The CLI provides complete automation for:

* Managing beta groups and testers
* Distributing builds to specific groups
* Collecting and reviewing crash reports and feedback
* Tracking beta tester metrics

## Beta Groups Workflow

<Steps>
  <Step title="List existing beta groups">
    View all beta groups for your app:

    ```bash theme={null} theme={null}
    asc testflight groups list --app "YOUR_APP_ID"
    ```

    Filter to internal or external groups:

    ```bash theme={null} theme={null}
    asc testflight groups list --app "YOUR_APP_ID" --internal
    asc testflight groups list --app "YOUR_APP_ID" --external
    ```
  </Step>

  <Step title="Create a new beta group">
    Create an external beta group:

    ```bash theme={null} theme={null}
    asc testflight groups create --app "YOUR_APP_ID" --name "External Beta Testers"
    ```

    Create an internal beta group:

    ```bash theme={null} theme={null}
    asc testflight groups create --app "YOUR_APP_ID" --name "QA Team" --internal
    ```
  </Step>

  <Step title="Configure group settings">
    Enable public link for external distribution:

    ```bash theme={null} theme={null}
    asc testflight groups edit --id "GROUP_ID" \
      --public-link-enabled \
      --public-link-limit-enabled \
      --public-link-limit 100
    ```

    Enable feedback collection:

    ```bash theme={null} theme={null}
    asc testflight groups edit --id "GROUP_ID" --feedback-enabled
    ```
  </Step>
</Steps>

## Managing Beta Testers

<Steps>
  <Step title="Add beta testers">
    Add a new tester to a beta group:

    ```bash theme={null} theme={null}
    asc testflight testers add \
      --app "YOUR_APP_ID" \
      --email "tester@example.com" \
      --group "Beta Testers"
    ```

    Optionally include name details:

    ```bash theme={null} theme={null}
    asc testflight testers add \
      --app "YOUR_APP_ID" \
      --email "tester@example.com" \
      --first-name "Jane" \
      --last-name "Doe" \
      --group "Beta Testers"
    ```
  </Step>

  <Step title="Import testers in bulk">
    Export existing testers to CSV:

    ```bash theme={null} theme={null}
    asc testflight testers export \
      --app "YOUR_APP_ID" \
      --output "./testers.csv"
    ```

    Import testers from CSV (with dry-run first):

    ```bash theme={null} theme={null}
    asc testflight testers import \
      --app "YOUR_APP_ID" \
      --input "./testers.csv" \
      --dry-run

    # After verifying, run without dry-run
    asc testflight testers import \
      --app "YOUR_APP_ID" \
      --input "./testers.csv"
    ```
  </Step>

  <Step title="List and filter testers">
    List all testers for an app:

    ```bash theme={null} theme={null}
    asc testflight testers list --app "YOUR_APP_ID"
    ```

    Filter by beta group:

    ```bash theme={null} theme={null}
    asc testflight testers list --app "YOUR_APP_ID" --group "Beta Testers"
    ```

    Filter by build:

    ```bash theme={null} theme={null}
    asc testflight testers list --app "YOUR_APP_ID" --build-id "BUILD_ID"
    ```
  </Step>

  <Step title="Send invitations">
    Invite a tester to start testing:

    ```bash theme={null} theme={null}
    asc testflight testers invite \
      --app "YOUR_APP_ID" \
      --email "tester@example.com"
    ```

    Invite and auto-create if tester doesn't exist:

    ```bash theme={null} theme={null}
    asc testflight testers invite \
      --app "YOUR_APP_ID" \
      --email "newtester@example.com" \
      --group "Beta Testers"
    ```
  </Step>
</Steps>

## Distributing Builds to Groups

<Steps>
  <Step title="Find your build ID">
    List recent builds:

    ```bash theme={null} theme={null}
    asc builds list --app "YOUR_APP_ID" --sort "-uploadedDate" --limit 5
    ```

    Get a specific build:

    ```bash theme={null} theme={null}
    asc builds info --app "YOUR_APP_ID" --version "1.0" --build-number "42"
    ```
  </Step>

  <Step title="Add build to beta groups">
    Add a build to one or more groups:

    ```bash theme={null} theme={null}
    asc builds add-groups --build-id "BUILD_ID" --group "GROUP_ID"
    ```

    Add to multiple groups:

    ```bash theme={null} theme={null}
    asc builds add-groups --build-id "BUILD_ID" --group "GROUP_ID1,GROUP_ID2"
    ```
  </Step>

  <Step title="Verify distribution">
    Check which groups have access to a build:

    ```bash theme={null} theme={null}
    asc testflight distribution view --build-id "BUILD_ID"
    ```
  </Step>
</Steps>

## Feedback and Crash Reports

<Steps>
  <Step title="View crash submissions">
    Get crash submission details:

    ```bash theme={null} theme={null}
    asc testflight crashes view --submission-id "SUBMISSION_ID"
    ```

    Download the crash log:

    ```bash theme={null} theme={null}
    asc testflight crashes log --submission-id "SUBMISSION_ID"
    ```
  </Step>

  <Step title="View screenshot feedback">
    Get screenshot submission with annotations:

    ```bash theme={null} theme={null}
    asc testflight feedback view --submission-id "SUBMISSION_ID"
    ```
  </Step>

  <Step title="Retrieve crash logs">
    Get detailed crash logs for analysis:

    ```bash theme={null} theme={null}
    asc testflight crashes log --crash-log-id "CRASH_LOG_ID"
    ```
  </Step>

  <Step title="Clean up old feedback (optional)">
    Delete processed crash submissions:

    ```bash theme={null} theme={null}
    asc testflight crashes delete --submission-id "SUBMISSION_ID" --confirm
    ```

    Delete screenshot submissions:

    ```bash theme={null} theme={null}
    asc testflight feedback delete --submission-id "SUBMISSION_ID" --confirm
    ```
  </Step>
</Steps>

## Beta Tester Metrics

Track how testers engage with your builds:

```bash theme={null} theme={null}
asc testflight metrics app-testers --app "YOUR_APP_ID"
```

This provides insights into:

* Number of sessions per tester
* App version usage
* Install and session counts

## Complete Example Workflow

Here's a complete workflow for distributing a new build:

```bash theme={null} theme={null}
# 1. Set your app ID
export ASC_APP_ID="YOUR_APP_ID"

# 2. Find the latest build
asc builds list --app "$ASC_APP_ID" --sort "-uploadedDate" --limit 1 --output json
BUILD_ID="..." # Extract from output

# 3. Create or find your beta group
asc testflight groups list --app "$ASC_APP_ID"
GROUP_ID="..." # Use existing or create new

# 4. Add build to the beta group
asc builds add-groups --build-id "$BUILD_ID" --group "$GROUP_ID"

# 5. List testers in the group
asc testflight testers list --app "$ASC_APP_ID" --group "$GROUP_ID"

# 6. Add new testers if needed
asc testflight testers add \
  --app "$ASC_APP_ID" \
  --email "newtester@example.com" \
  --group "Beta Testers"

# 7. Send invitations
asc testflight testers invite --app "$ASC_APP_ID" --email "newtester@example.com"

# 8. Monitor beta tester activity
asc testflight metrics app-testers --app "$ASC_APP_ID"
```

## Troubleshooting

### Tester Not Receiving Invitation

1. Verify the tester is added to the group:
   ```bash theme={null} theme={null}
   asc testflight testers list --app "YOUR_APP_ID" --group "GROUP_ID"
   ```

2. Check if invitation was sent:
   ```bash theme={null} theme={null}
   asc testflight testers view --id "TESTER_ID"
   ```

3. Resend invitation:
   ```bash theme={null} theme={null}
   asc testflight testers invite --app "YOUR_APP_ID" --email "tester@example.com"
   ```

### Build Not Appearing for Testers

1. Verify build is assigned to the group:
   ```bash theme={null} theme={null}
   asc testflight distribution view --build-id "BUILD_ID"
   ```

2. Check build processing status:
   ```bash theme={null} theme={null}
   asc builds info --build-id "BUILD_ID"
   ```

3. Ensure build passed TestFlight review:
   ```bash theme={null} theme={null}
   asc testflight review submissions list --build-id "BUILD_ID"
   ```

### Managing Group Limits

Internal groups have a limit of 100 testers. External groups can have up to 10,000 testers.

To check current tester counts:

```bash theme={null} theme={null}
asc testflight groups view --id "GROUP_ID"
```

If you hit limits, create additional groups:

```bash theme={null} theme={null}
asc testflight groups create --app "YOUR_APP_ID" --name "Beta Testers Group 2"
```

## Best Practices

1. **Organize by testing focus**: Create separate groups for different testing purposes (QA, feature testing, general beta)

2. **Use CSV import for bulk operations**: Export your current tester list, make changes, and re-import

3. **Enable feedback collection**: Turn on feedback for external groups to collect valuable user input

4. **Monitor crash reports**: Regularly check crash submissions and address issues before App Store release

5. **Set public link limits**: For public beta links, set reasonable limits to control your beta population size

6. **Track metrics**: Use beta tester usage metrics to identify your most active testers

## Related Commands

* [App Store Submission](/guides/app-store-submission) - Submit builds for App Store review
* [Build Management](/commands/builds) - Manage builds in App Store Connect
* [Analytics and Reports](/guides/analytics-reports) - Download usage and crash analytics