Skip to main content
TestFlight setup and beta distribution Level: Intermediate 14 min read

Multi-Track TestFlight Testing: Staging Alpha, QA, and Public Beta Builds

A complete architectural and operational guide to implementing multi-track distribution (Alpha, QA, Staging, and Public Beta) in Apple TestFlight using FlightDeck MCP.

Published: 2026-11-02 • Last Updated: 2026-11-02 • Author: Kip Lawrence
Key MCP Tools: beta_groups_listbeta_group_createbuilds_listbuild_beta_details_getbuild_add_to_beta_groupbuild_remove_from_beta_group

Overview: Designing a Multi-Track TestFlight Pipeline

Developers coming to Apple TestFlight from platforms like Google Play often search for native release "tracks" (such as Internal, Closed, Open, and Production). In Apple's ecosystem, tracks are not first-class API resources. TestFlight does not have a dedicated "tracks" setting or pipeline object in App Store Connect.

Instead, professional iOS engineering teams implement multi-track delivery as an organizational architecture using multiple TestFlight Beta Groups, differentiated build assignments, and automated CI/CD pipelines.

By creating distinct cohorts—such as an internal Alpha group for engineers, a restricted QA group for product stakeholders, and an external Public Beta group for community testers—you can test bleeding-edge builds internally while keeping external testers on stable release candidates.

Using FlightDeck's Model Context Protocol (MCP) server, your AI coding assistant can inspect your cohort matrix, stage group configurations, and associate different builds across tracks without manual web portal overhead.

This guide explains how to design a multi-track TestFlight topology, how Apple's review gates govern track progression, and how to operate your pipeline using natural-language AI prompts.


1. Multi-Track Architecture: Group Topology and Review Boundaries

In TestFlight, a multi-track architecture is built by combining Internal Beta Groups (no review gate, team members only) and External Beta Groups (Beta App Review required, public link or email invites):

TEXT
+-----------------------------------------------------------------------------------+
|                        TESTFLIGHT MULTI-TRACK TOPOLOGY                            |
+-----------------------------------------------------------------------------------+
|                                                                                   |
|                               +------------------+                                |
|                               |   Target App     |                                |
|                               +--------+---------+                                |
|                                        |                                          |
|            +---------------------------+---------------------------+              |
|            |                           |                           |              |
|   +--------v---------+        +--------v---------+        +--------v---------+    |
|   |  TRACK 1: ALPHA  |        |   TRACK 2: QA    |        |  TRACK 3: BETA   |    |
|   | (Internal Group) |        | (Internal / Ext) |        | (External Group) |    |
|   +--------+---------+        +--------+---------+        +--------+---------+    |
|            |                           |                           |              |
|   - Max 100 dev users         - Curated team/QA           - Up to 10,000 testers  |
|   - No Apple Beta Review      - Validates RC builds       - Mandatory Beta Review |
|   - Auto-deploy every CI      - Regression testing        - Public link enabled   |
|   - Build: 2.1.0 (Build 55)   - Build: 2.1.0 (Build 50)   - Build: 2.0.0 (Build 42|
+-----------------------------------------------------------------------------------+

Dimension Track 1: Internal Alpha Track 2: Staging / QA Track 3: Public Beta
Group Type Internal (isInternalGroup: true) Internal or External (depending on whether QA includes contractors) External (isInternalGroup: false)
Audience Core engineers, internal designers. QA analysts, product managers, executive stakeholders, agency clients. Early adopters, community members, power users.
Review Delay No Beta App Review. Available once processing reaches VALID, compliance is attested, and edge distribution completes. No Beta App Review if internal; standard review turnaround for 1st build of version if external. Beta App Review required for the first build of any marketing version.
Build Cadence Nightly or per-commit continuous builds. Release candidate (RC) builds at end of sprint. Stable milestone releases updated bi-weekly or monthly.
Capacity Limit Up to 100 team accounts across organization. Up to 100 if internal; up to 10,000 if external. Up to 10,000 testers across all external groups.


2. Managing Multiple Active Builds Concurrently

A crucial feature of TestFlight is that different beta groups can test different builds simultaneously:

  • Alpha Track: Assigned Build 55 (containing unfinished experimental features).
  • QA Track: Assigned Build 50 (frozen for regression verification).
  • Beta Track: Assigned Build 42 (previously approved and distributed to community testers).

Testers only see and download the builds assigned to the specific groups they belong to. When a tester belongs to multiple groups that have different builds assigned, TestFlight displays the newest build by default, but allows the tester to select and install earlier builds via the "Previous Builds" section in the TestFlight app.

The 90-Day Clock: Every TestFlight build expires exactly 90 calendar days after its upload timestamp. Operating a continuous multi-track pipeline requires uploading fresh builds periodically so your stable tracks do not lapse unexpectedly.


3. FlightDeck MCP Implementation & Safety Rules

Operating a multi-track pipeline involves frequent build assignments and cohort inspections. FlightDeck provides high-level semantic tools to govern this workflow:

  • beta_groups_list: Lists all groups, their cohort classification, and member counts.
  • beta_group_create: Creates dedicated track containers (isInternalGroup, publicLinkEnabled, publicLinkLimit).
  • builds_list: Lists all builds, their version strings, and processing states.
  • build_beta_details_get: Verifies export compliance and Beta App Review status.
  • build_add_to_beta_group: Stages assigning a specific build to a target track.
  • build_remove_from_beta_group: Unassigns an outdated build from a track.

The Desktop Approval Center Invariant

All mutating operations (beta_group_create, build_add_to_beta_group, build_remove_from_beta_group) require explicit authorization in the FlightDeck Desktop Approval Center (HUMAN_APPROVAL_REQUIRED).

When your assistant proposes promoting a build from Alpha to QA or Beta, FlightDeck displays a visual proposal card showing the exact build number, group name, and app ID. Changes are never pushed to Apple's API without your physical confirmation.


4. Step-by-Step Prompt Workflows

4.1 Auditing the Existing Multi-Track State

Before promoting builds or restructuring cohorts, instruct your assistant to map your current distribution matrix.

Using FlightDeck, inspect all TestFlight beta groups for [App Name]. Detail which groups are internal vs external, what build numbers are currently assigned to each group, and whether any builds have expired or are awaiting review. Do not stage or execute any mutations.

What the Assistant Does:

  1. Calls apps_list to locate the target appId.
  2. Calls beta_groups_list(appId: "<appId>") to identify existing cohorts.
  3. For each group, queries assigned builds.
  4. Outputs a structured matrix displaying active tracks, build numbers, and review states.

4.2 Setting Up the Multi-Track Group Hierarchy

If you are establishing a new app's TestFlight architecture, instruct your assistant to stage the three core tracks sequentially:

I want to set up a 3-track TestFlight distribution architecture for [App Name]:

  1. "Internal Engineering" (Internal group, access to all builds enabled).
  2. "Stakeholder QA" (Internal group, access to all builds disabled).
  3. "Public Beta" (External group, public link enabled with a 500-tester limit).

Check whether any of these groups already exist. Propose the setup plan and stage the group creations for my approval in FlightDeck.

Execution Sequence:

  1. Validation: Assistant verifies that none of the three group names collide with existing groups in beta_groups_list.
  2. Phase 1 (Internal Engineering): Stages beta_group_create (isInternalGroup: true, hasAccessToAllBuilds: true). You approve in FlightDeck Desktop.
  3. Phase 2 (Stakeholder QA): Stages beta_group_create (isInternalGroup: true, hasAccessToAllBuilds: false). You approve in Desktop.
  4. Phase 3 (Public Beta): Stages beta_group_create (isInternalGroup: false, publicLinkEnabled: true, publicLinkLimit: 500). You approve in Desktop.
  5. Readback: Assistant calls beta_groups_list to capture the three live groupId identifiers.

4.3 Promoting a Release Candidate from QA to Public Beta

Once a release candidate passes stakeholder QA, promote it to your external public beta track:

Check recent builds for [App Name] using FlightDeck. Identify the build currently assigned to "Stakeholder QA". Verify that this build has passed Apple Beta App Review. Once verified, stage an association adding this build to our "Public Beta" group. Show me the build number and verification status before staging.

Verification Checklist:

  • Processing Status: processingState == "VALID".
  • Export Compliance: Attested.
  • Review Gate: If this is the first build of a new marketing version, the assistant checks build_beta_details_get to confirm externalBetaState indicates approval.
  • Staging: The assistant stages build_add_to_beta_group for your authorization.
  • Approval: You click Approve in the FlightDeck Desktop Approval Center.
  • Readback: The assistant queries beta_groups_list to verify that the build is actively associated with the Public Beta track.

4.4 Pruning Superseded Builds from a Track

To avoid tester confusion, unassign older builds when a newer stable build is distributed:

In our "Public Beta" group for [App Name], identify any older builds that have been superseded by the latest release candidate. Stage a removal to unassign the older build from the group so testers only receive the latest version.

The assistant stages build_remove_from_beta_group to detach the older build while leaving it active in other groups.


5. Coordinating with CI/CD Pipelines

A mature multi-track pipeline balances automated continuous delivery with human release governance:

  1. Automated CI Build & Ingestion: Your CI runner (GitHub Actions, Xcode Cloud, Fastlane) compiles your archive on every commit to main and uploads it to App Store Connect (build_upload_start).
  2. Auto-Assignment to Alpha: Once processing reaches VALID, CI or an automated script immediately attaches the build to "Internal Engineering", giving your developers immediate device access.
  3. Human Gate to QA & Beta: Promotion to Stakeholder QA and Public Beta is held behind FlightDeck Desktop Approval. An engineering lead instructs the assistant to verify the build, review automated test outputs, and approve the promotion diff card.

6. Summary of Best Practices

  1. Keep External Cohorts Selective: Do not enable hasAccessToAllBuilds on external groups. External testers should only receive thoroughly vetted builds.
  2. Track Build Progression: Maintain consistent build numbering (CFBundleVersion) so testers and tools can trace progression from Alpha to QA and Production.
  3. Minimize Notification Fatigue: Avoid pushing multiple daily builds to groups containing non-engineering stakeholders. Batch changes into coherent sprint release candidates.
  4. Always Read Back After Assigning: Use beta_groups_list or build_beta_details_get to verify that the relationship was recorded on Apple's servers.

Connect Your AI Agent to App Store Connect

FlightDeck runs locally on your Mac, keeping private keys secure in your macOS Keychain and executing mutations only after your explicit approval.

Download FlightDeck on Mac App Store