Test a beta version

Add testers to builds

Learn how to add testers to builds with the App Store Connect API.

Required role: Account Holder, Admin, or App Manager. View role permissions.

Add a group to a build

You'll need to create a group before adding it to a build. All testers in the group will have access to the build.

  1. From Apps, select your app.

  2. Click the TestFlight tab.

  3. In the sidebar, under Builds, click the platform.

  4. On the right, select a build by clicking the app icon or build string for the build from either the Versions or Build Groups tab.

  5. Next to Groups, click the add button (+).

    Note: Builds that are indicated as internal can only be added to internal tester groups.

  6. Select the group you want to add to the build, then click Add.

    You will not be able to select a group to which the build was already added.

    You can also quickly add a tester group to a build directly in the Versions or Build Groups tab. In the Groups column next to the build, click the add button (+), then select a group from the list of eligible groups.

Add individuals to a build

You can add individual internal or external testers to a build. Individual testers can't be added to builds that are indicated as internal.

  1. From Apps, select your app.

  2. Click the TestFlight tab.

  3. In the sidebar, under Builds, click the platform.

  4. On the right, select a build by clicking the app icon or build string for the build from either the Versions or Build Groups tab.

  5. Next to Individual Testers, click the add button (+) and choose an option from the pop-up menu.

    You can add new testers, existing testers, or import testers from a CSV file.

  6. Enter the required information for a tester, then click either Add or Invite.

Remove tester groups or individuals from a build

  1. From Apps, select your app.

  2. Click the TestFlight tab.

  3. In the sidebar, under Builds, click the platform.

  4. On the right, select a build by clicking the app icon or build string for the build from either the Versions or Build Groups tab.

  5. Under either Groups or Individual Testers, hold the pointer over the group or individual tester you want to remove, then click the delete button (–) that appears to the right of the table.

  6. In the dialog that appears, click Remove.

    All eligible builds are automatically available to users in the App Store Connect Users group. Learn how to remove testers from a group.

    You can also quickly remove a tester group from a build directly from the builds table. Click the add button (+) under the Groups column next to the build to view the pull-down menu of groups. Click the group you’d like to remove. In the dialog that appears, click Remove.