Add internal testers
Create a group and add up to 100 internal testers (App Store Connect users with access to your content) to test your app using TestFlight. You can choose to automatically distribute builds to internal groups or add them manually. Builds created by Xcode Cloud must be manually added to groups in App Store Connect. Builds uploaded as TestFlight Internal Only from Xcode or Xcode Cloud will be indicated as internal under the build number. Builds with this indicator can only be added to internal tester groups and cannot be submitted for external testing or to the App Store.
Note: Managed Apple IDs can’t be used to test builds.
Learn how to manage testers with the App Store Connect API.
Required role: Account Holder, Admin, App Manager, Developer, or Marketing. View role permissions.
Create a group
-
From My Apps, select your app.
-
Click the TestFlight tab.
-
In the sidebar, click the add button (+) next to Internal Testing.
-
In the dialog that appears, enter the name for a new internal group, then click Create. You can change the name later, if needed.
Select the “Enable automatic distribution” checkbox to allow Xcode to automatically deliver builds to everyone in the group. If automatic distribution is not enabled, all builds must be manually added to the group. Builds created by Xcode Cloud always need to be manually added to groups in App Store Connect.
Add internal testers to a group
-
From My Apps, select your app.
-
Click the TestFlight tab.
-
In the sidebar next to Internal Testing, click the add button (+).
-
Next to Testers, click the add button (+).
Users that are eligible to be internal testers appear in a dialog. If a user you want to add doesn’t appear, change their user role.
-
Select the checkbox next to each user you want to invite, then click Add.
If you have builds available for testing, the users you select will receive an email inviting them to test the app. They’ll be directed to accept the invitation using the TestFlight app on their device or via a redemption code on Apple TV. Internal testers can download and test all builds for 90 days.
Add builds to a group
-
From My Apps, select your app.
-
Click the TestFlight tab.
-
In the sidebar, click the group you want to add a build to.
-
On the right, click the add button (+) next to Builds.
-
Select the build you want to add to the group, then click Next.
Note: Builds that are indicated as internal can only be added to internal tester groups.
-
Enter the What to Test information and optionally enter localized versions of test information in the fields under each language-specific section.
Note: This information will be available to testers in all groups that have access to the build.
-
Click Add.
If you have builds available for testing, the users you selected will receive an email inviting them to test the app. The users will be directed to accept the invitation using the TestFlight app on their device or via a redemption code. Internal testers will be able to download and test all builds for 90 days.