# TestFlight

<div align="left"><img src="https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2FnXVjhOKVqZ5BrysHEurN%2Ftestflight.png?alt=media&#x26;token=0bffe342-7bb4-49d4-a6a2-c3ced67977bc" alt=""></div>

### Set up

#### Navigate to the Integration settings view

1. Select an app in the top left corner from the Switcher
2. Navigate to **App Settings** by clicking the gear icon (⚙️) at the top of the Timeline sidebar
3. Click on **Integrations** in the sidebar

#### Connect TestFlight

* Find the **TestFlight** integration module under the **Beta testing** section
* Click the **Connect** button
* Select an existing App Store Connect installation, or enter your ASC API key’s Key ID and Issuer ID, and upload the .p8 key file
* Click **Save**; you’ll be presented with a dialog in which to enter your [TestFlight settings](#testflight-settings)

{% hint style="info" %}
You can generate API keys within App Store Connect.

* You must be logged into App Store Connect with an **Admin** account to generate API keys.
* Runway requires an API key with the **App Manager** role.

:link: [**Apple - Creating API Keys for App Store Connect API**](https://developer.apple.com/documentation/appstoreconnectapi/creating_api_keys_for_app_store_connect_api).
{% endhint %}

![Issuer ID, Key ID, and download link from the Users and Access section in App Store Connect](https://727226624-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MjFmyReUsbJqDjHEAlW%2Fuploads%2FzQdUmlz0TwAU28wWkZoJ%2Fimage.png?alt=media\&token=96f7a90d-4f17-4adf-803a-dc952269e587)

### TestFlight settings

* Enter your TestFlight settings:
  * **Bundle ID** — Choose the bundle ID of the app you use for beta testing. You can choose the same bundle ID as your production app, or select an alternate one linked to this App Store Connect installation if you use a different app for beta testing.

{% hint style="success" %}
If you enable the '[Assign beta testing builds to default testing groups](https://docs.runway.team/automations/types-of-automations#assign-beta-testing-builds-to-default-testing-groups)' automation, you can select default external beta groups to distribute builds to.
{% endhint %}

{% hint style="warning" %}
Beta builds distributed through TestFlight require approval from Apple before they become available to external testers. Note that all eligible builds will be immediately available to users in the App Store Connect Users group (these are considered ‘internal testers’ by Apple).

Beta builds can be manually submitted for approval via Runway, or you can enable the [Submit new builds for beta review](https://docs.runway.team/automations/types-of-automations#submit-new-builds-for-beta-review) automation.
{% endhint %}