Test a beta version

Invite external testers

You can invite up to 10,000 external testers (people who aren’t App Store Connect users with access to your content) per app to test your app using TestFlight once you’ve uploaded at least one build. In order to make your build available for external testing, you'll need to create a group, add builds, and invite testers using their email address or by sharing a public invitation link.

Note: 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.

Note: Managed Apple IDs can’t be used to test builds.

Learn how to manage tester invitations with the App Store Connect API.

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

Create a group

  1. From My Apps, select your app.

  2. Click the TestFlight tab.

  3. In the sidebar, click the add button (+) next to External Testing to add a new group.

  4. In the dialog that appears, enter a group name, then click Create.

    Later, you can change the name of the group if needed.

Add builds to a group

  1. From My Apps, select your app.

  2. Click the TestFlight tab.

  3. In the sidebar, under External Testing, select the group you want to add builds to.

  4. On the right, click the add button (+) next to Builds.

  5. In the build dialog, select the platform and version from the pop-up menus.

  6. From the table, select a build, then click Next.

    Although you can add only one build at a time, you can add additional builds later.

    Note: Enter test information such as Feedback Email and Contact Information if these details have not yet been provided in the Test information dialog.

  7. In the What to Test dialog, enter what you want testers to focus on.

  8. Optionally, enter localized versions of testing information in the text fields under each language-specific section.

  9. Optionally, select “Automatically notify testers.”

    If you leave this checkbox deselected, you will have to manually distribute the build to testers after it's approved by TestFlight App Review later.

  10. Depending on the status of the build, click either Submit Review or Start Testing.

    You can only have one build of each version in review at a time. Once that build is approved, you can submit additional builds.

After you submit your build to TestFlight App Review, Apple reviews the build and the accompanying metadata. The first build you submit requires a full review, but later builds for the same version may not.

If Apple approves your build for TestFlight beta testing, users on the App Store Connect account with the Admin role will receive an email notifying them of the approval.

If Apple rejects your build or metadata, the status of the build will be Rejected. You can click App Review from the sidebar under General to visit rejection details for your beta build.

Note: Submitting a build to TestFlight App Review doesn’t submit it to App Review for sale in the App Store.

Invite external testers

Once you have builds available to test, and you've added them to a group, you can invite testers.

  1. From My Apps, select your app.

  2. Click the TestFlight tab.

  3. In the sidebar, under Testers & Groups, select a group.

    You can Invite testers using a public link, email, or both.

To invite testers using a public link:

1. Click Enable Public Link, and confirm in the dialog that appears.

2. Under Tester Count, click Set Limit to limit the number of testers that can join this testing group using the public link. Enter a number between 1 and 10,000.

set tester limit

3. Copy the link, and share it using social media, messages, email, or other channels.

Keep in mind that anyone can share this link, so testers may be able to join your testing group even if you don't invite them directly. If a tester joins your group using a public link, their name and email won’t be displayed in the Testers section in App Store Connect (it will display as anonymous), but their installation date, sessions, and crashes will be displayed. You can disable the public link at any time.

To invite testers using their email address:

1. Click the add button (+) next to Testers.

2. In the pop-up menu that appears, choose an option. You can add new testers using their email address, existing testers you've previously added, or import testers from a CSV file.

3. Testers you invite will get an invitation email to start testing. If a tester accepts an email invitation, their name, email address, installation date, sessions, and crashes, will display in the Testers section in App Store Connect.

Notify external testers after your build is approved

If you didn’t select “Automatically notify testers” when you added your build to your group, you must manually notify testers when your build is approved.

  1. From My Apps, select your app.

  2. Click the TestFlight tab.

  3. In the sidebar, under Builds, click the platform for your app.

  4. Choose a version, then under Status, click Notify Testers for the build row.

The build status changes to Testing. The external testers will receive a notification directing them to accept the invitation using the TestFlight app on their device.

Remove a build from a group

  1. From My Apps, select your app.

  2. Click the TestFlight tab.

  3. In the sidebar, under Testers & Groups, select a group.

  4. On the right, under Builds, hold the pointer over the build you want to remove.

  5. Click the delete button.

  6. In the dialog that appears, confirm you want to remove the build from the group and click Remove.

If you want to remove a build from testing for all your testers, go to Stop testing a build.

How do I appeal if my beta build was rejected?

To appeal your beta build being rejected, contact TestFlight App Review.