Installing and testing beta apps

Each build is available to test for up to 90 days, starting from the day the developer uploads their build. You can see how many days you have left for testing under the app name in TestFlight. TestFlight will notify you each time a new build is available and will include instructions on what you need to test. Alternatively, with TestFlight 3 or later, you can turn on automatic updates to have the latest beta builds install automatically.

When the testing period is over, you’ll no longer be able to open the beta build. To install the App Store version of the app, download or purchase the app from the App Store. In-app purchases are free only during beta testing, and any in-app purchases made during testing will not carry over to App Store versions.

Note: To automatically download additional in-app content and assets in the background once a beta app is installed in iOS 16, iPadOS 16, or macOS 13, turn on Additional In-App Content in your App Store settings for iPhone, iPad, and Mac.

Installation

To get started, install TestFlight on the device you’ll use for testing. Then, accept your email invitation or follow the public link invitation to install the beta app. You can install the beta app on up to 30 devices.

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

Installing a beta iOS or iPadOS app via email or public link invitation

  1. Install TestFlight on the iOS or iPadOS device that you’ll use for testing.
  2. Open your email invitation and tap “View in TestFlight” or tap the public link on your device.
  3. If you’re a new tester for the app, tap Accept.
  4. Tap Install to install the app on your device.
  5. If you’re a returning tester, tap Update or Open.

Installing a beta macOS app via email or public link invitation

  1. Install TestFlight on the Mac that you’ll use for testing.
  2. Open your email invitation and click “View in TestFlight” or click the public link on your Mac.
  3. If you’re a new tester for the app, click Accept.
  4. Click Install to install the app on your device.
  5. If you’re a returning tester, click Update or Open.

Installing a beta tvOS app via email invitation

  1. Install TestFlight on Apple TV.
  2. Open your email invitation on a mobile device or computer.
  3. Tap or click “View in TestFlight”. You’ll be taken to a web page with a redemption code.
  4. Open TestFlight on Apple TV.
  5. Go to Redeem and enter the redemption code.

Installing a beta tvOS app via public link invitation

  1. Install TestFlight on an iOS or iPadOS device and Apple TV where you can sign in to the same App Store account.
  2. Tap the public link on your device.
  3. Tap Accept for the app you want to test.
  4. Open TestFlight on Apple TV. You must be signed in to the same App Store account you used on your device.
  5. Install the app you want to test.

Installing a beta visionOS app via email or public link invitation

  1. Open your email invitation and touch “View in TestFlight” or touch the public link on your device.
  2. If you’re a new tester for the app, touch Accept.
  3. Touch Install to install the app on your device.
  4. If you’re a returning tester, touch Update or Open.

Installing a beta watchOS app via email or public link invitation

  1. Install TestFlight on the iOS device paired with the Apple Watch that you’ll use for testing.
  2. Open your email invitation and tap “View in TestFlight” or tap on the public link on your iOS device.
  3. If you’re a new tester for the app, tap Accept.
  4. If you’re testing an app that’s for Apple Watch only, tap “Install” from the Apps list.
  5. If the app is an iOS app that includes an Apple Watch app, install the iOS app first, then go to the App Details page in the Information section. If the Apple Watch app is available and compatible with your watch, there will be a button to install, update, or open it.

Testing

Testing iMessage apps (iOS or iPadOS 10, or later)

  1. Install TestFlight on the iOS or iPadOS device that you’ll use for testing.
  2. Open your email invitation and tap “View in TestFlight” or tap the public link on your iOS device.
  3. If you’re a new tester for the app, tap Accept.
  4. Tap Install to install the app on your device.
  5. If you’re a returning tester, tap Update or Open.

If you’re testing an iOS app that includes an iMessage app, launch the beta app from the Home Screen.

If you’re testing an app that’s for iMessage only or a sticker pack, launch it from within Messages.

Testing beta App Clips (iOS or iPadOS 14, or later)

After accepting your email or public link invitation to test the app, you’ll see the option to test the App Clip in TestFlight. You can install either the app or the App Clip on your device (but not both at once), and can replace one with the other at any time. If the app is installed on your device, testing the App Clip will replace the app and some app data may be lost. You can reinstall the app by tapping Install on the app’s page in TestFlight.

  1. Install TestFlight on the iOS or iPadOS device that you’ll use for testing.
  2. Open your email invitation and tap “View in TestFlight” or tap the public link on your iOS device.
  3. If you’re a new tester for the app, tap Accept.
  4. Tap Install to install the app on your device.
  5. Go to the app’s page in TestFlight.
  6. In the App Clips section, tap TEST next to the beta App Clip you want to test.

Managing automatic updates

After installing TestFlight 3 or later for iOS, iPadOS, or tvOS, TestFlight for visionOS, or TestFlight for macOS, you’ll be prompted to turn on automatic updates. This allows the latest available beta builds to install automatically. TestFlight will notify you each time a new build is installed on your device. Automatic updates can be turned off at any time.

Use TestFlight to change automatic update settings for all of the beta apps you’re testing using TestFlight:

Note: This setting will apply to all new beta app builds. Beta apps that have automatic updates set at the individual app level won’t be affected

TestFlight for iOS or iPadOS

  1. Open TestFlight and tap Settings in the top right.
  2. Tap Automatic Updates for New Apps.
  3. Tap On or Off.

TestFlight for macOS

  1. Open TestFlight and choose Preferences from the TestFlight menu.
  2. Under General, select Automatic Updates for New Apps.

TestFlight for tvOS

  1. Open TestFlight and click the Settings tab at the top.
  2. Select Automatic Updates
  3. Turn Automatic Updates On or Off

TestFlight for visionOS

  1. Open TestFlight and from the bottom left, touch open your profile.
  2. Under App Settings, touch Automatic Updates for New Apps to turn it on or off.

Use TestFlight to change automatic update settings for individual beta apps you’re testing:

TestFlight for iOS or iPadOS

  1. Open TestFlight and go to the app’s page.
  2. Under App Information, turn Automatic Updates On or Off.

TestFlight for visionOS

  1. Open TestFlight and go to the app’s page.
  2. Under App Settings, touch Automatic Updates to turn it on or off.

TestFlight for macOS

  1. Open TestFlight and go to the app’s page.
  2. Under App Settings, select Automatic Updates.

TestFlight for tvOS

  1. Open TestFlight and go to the app’s page.
  2. Under the app icon, click More.
  3. Click Turn On Automatic Updates or Turn Off Automatic Updates.

Testing builds from previous versions and build groups

When viewing an app in TestFlight, you’ll see the latest available build by default. You can still test all other builds that are available to you.

If you already have the App Store version of the app installed on your device, the beta version of the app will replace it. After you download the beta app, you’ll see an orange dot next to its name that identifies it as a beta.

When you accept a TestFlight invitation through a public link, your name and email address aren’t visible to the developer. However, they’ll be able to see your number of sessions and crashes, the day you installed their app, and the latest installed version.

TestFlight for iOS and iPadOS

  1. Open TestFlight and go to the app’s page.
  2. Tap Previous Builds or, if you’re using Xcode Cloud, tap Versions and Build Groups.
  3. Tap either the Versions tab or Build Groups tab, then tap and install the build you want to test. The build you choose will replace what’s currently installed.

TestFlight for macOS

  1. Open TestFlight and go to the app’s page.
  2. Next to Build Information, click View Previous Builds or, if you’re using Xcode Cloud, click Versions and Build Groups.
  3. Click either the Versions or Build Groups tab, then select and install the build you want to test. The build you choose will replace what’s currently installed.

TestFlight for tvOS

  1. Open TestFlight and go to the app’s page.
  2. Select View Previous Builds or, if you’re using Xcode Cloud, click Versions and Build Groups.
  3. Click the Versions tab or the Build Groups tab, then select and install the build you want to test. The build you choose will replace what’s currently installed.

TestFlight for visionOS

  1. Open TestFlight and go to the app’s page.
  2. Next to Build Information, touch View Previous Builds.
  3. Touch either the Versions tab or Build Groups tab, then touch Install next to the build you want to test. The build you choose will replace what’s currently installed.