Set up an open, closed, or internal test

We recommend starting with an internal test, then expanding to a small group of closed testers. Developers with personal accounts created after November 13, 2023, must meet specific testing requirements before they can make their app available on Google Play and, by extension, before they can use pre-registration. Read this Help Center article to learn more.

If you want to run multiple tests on the same app, keep the following in mind:

• At any time, you can run multiple closed tests and one open test.
• A user who opts into your app's internal test is no longer eligible to receive an open or closed test. To gain access to an open or closed test, the user must first opt out of the internal test and then opt in to the open or closed test.

You can create a list of internal testers by email address. An internal test can have up to 100 testers per app.

When setting up an internal test, keep the following in mind:

• Country distribution: You can add users from any location to your internal test. If an internal tester is located in a country where your app's production or open or closed testing version isn't available, the user will still receive access to the internal test.
• Payment: For paid apps, testers can install your internal test version for free. Testers need to pay for in-app purchases unless they're also added to a licensed testers list.
• Device exclusion rules: Device exclusion rules don't apply to internal testers.

• Policy and security reviews: Internal tests may not be subject to the usual Play policy or security reviews. Apps that are active on internal testing tracks are exempt from inclusion in Google Play's Data safety section.

Start an internal test

Create an email list of your testers:

If you've already created an email list, skip to the "Add testers" instructions.

1. Open Play Console and go to the Internal testing page (Testing > Internal testing).
2. Select the Testers tab.
3. Under "Testers," select Create email list.
4. Enter a list name. You can use the same list for future tests on any of your apps.
5. Add email addresses separated by commas or click Upload CSV file. If you use a .CSV file, put each email address on its own line without any commas. Note the following:
   • If you upload a .CSV file, it will overwrite any email addresses you've added. 
   • Play Console does not accept .CSV files that are in UTF-8 with BOM format.
6. Select Save changes, then Create.

Add testers

1. Open Play Console and go to the Internal testing page (Testing > Internal testing).
2. Select the Testers tab.
3. In the "Testers" table, select the user lists you want to test your release.
4. Provide a feedback URL or email address to collect feedback from testers. Your app's feedback channel will be shown to users on your tester opt-in page.
5. Copy the shareable link to share the release with testers.
6. Select Save changes.

Test apps that are not fully configured

You can also create an internal testing release if your app isn’t fully configured. As soon as you have a valid app bundle, you can quickly distribute it to a limited number of testers. If you want to test an app that isn’t fully configured, you should note the following:

• Before the app is reviewed for the first time, users will see a temporary name for the app on Google Play. You can find your app’s temporary name in the app summary on your app’s Dashboard.
• As soon as you upload an artifact, the package name for that app is fixed and cannot be changed.

With a closed test, you can create a list of testers by email address. You can create a total of 200 lists, and each list can have up to 2,000 users. You can create up to 50 lists per track.

Enter the required information to prepare your internal testing release, save your changes, and select Review release.

Start a closed test

Create an email list of your testers

If you've already created your testers list, skip to the "Add testers" instructions.

1. Open Play Console and go to the Closed testing page (Testing > Closed testing).
2. Select Manage track.
3. Select the Testers tab.
4. Under "Testers," select Create email list.
5. Enter a list name. You can use the same list for future tests on any of your apps.
6. Add email addresses separated by commas or click Upload CSV file. Note the following:
   • If you upload a .CSV file, it will overwrite any email addresses you've added. 
   • Play Console does not accept .CSV files that are in UTF-8 with BOM format.
7. Select Save changes, then Create.

Add testers

1. Open Play Console and go to the Closed testing page (Testing > Closed testing).
2. Select Manage track.
3. Select the Testers tab.
4. In the "Testers" section, you can add testers via email or Google Groups:
   • Email: Email is selected automatically. If you want to use email, just select the user lists you want to test your release.
   • Google Groups: Select Google Groups and enter the Google Group email addresses, which use the format: [email protected]. Only users who are members of the Google Groups you enter will be able to join your test.

     • Tip: To learn how to manage Google Groups, go to the G Suite Administrator Help Center.

5. Provide a feedback URL or email address to collect feedback from testers. Your app's feedback channel will be shown to users on your tester opt-in page.

6. Copy the shareable link to share the release with testers.

7. Select Save changes.

With a closed test, you can choose which organization can access your track. Admins of these organizations can assign users to test your release.

We recommend that you only add your testers either through Play Console OR from the Android app settings page in the Google Admin console. If a user is selected to test from both Play Console and Admin console, they will get the highest version among all the app versions available.

To add a tester:

1. Open Play Console and go to the Closed testing page (Testing > Closed testing).
2. Select Manage track.
3. Select the Testers tab.
4. In the "Manage organizations" section, select Add organization.
5. Enter the ID and name of the organization that can access your track.
6. Select Add.
   • Tip: To learn how to manage organizations, go to the Google Workspace Admin Help Center.
7. Select Save changes.

If you set up an open test, users can find your test app on Google Play. Make sure your app is ready to be visible on Google Play before choosing this option.

• For early access apps (new apps that haven't been published to production): Users can find your open test via search on Google Play. Once users find your listing, they can install and use your app.
• For apps with a live production version: Users can opt-in to your open test from your store listing.

You can also share a URL link on a website or email. Every user with the link can access the open test.

Start an open test

1. Open Play Console and go to the Open testing page (Testing > Open testing).
2. Select the Testers tab.
3. Expand the "Manage testers" section. If the "Manage testers" section is empty, make sure you've uploaded an app bundle.
4. Choose how many testers can use your app:
   • Unlimited: This option is selected by default.
   • Limited number: You can specify a limit (must be at least 1,000).
5. Provide a feedback URL or email address to collect feedback from testers. Your app's feedback channel will be shown to users on your tester opt-in page.
6. Copy the shareable link to share the release with testers.
7. Select Save changes.

In some cases, you may need additional closed test tracks. For example, you might have different development teams that need to address bugs across different features. If each team creates their own testing track, teams can work on different features at the same time.

With additional test tracks, you can create a list of testers by email address or manage testers by Google Groups. There are no size limits to these groups.

Create an additional test track

1. Open Play Console and go to the Closed testing page (Testing > Closed testing).
2. Near the top right of the page, select Create.
3. Enter a track name. The track title is used in the Play Console and Google Play Developer API as the track name.
4. Select Create track.
5. Select the Testers tab.
6. In the "Testers" section, you can add testers via email or Google Groups:
   • Email: Email is selected automatically. If you want to use email, just select the user lists you want to test your release.
   • Google Groups: Select Google Groups and enter the Google Group email addresses, which use the format: [email protected]. Only users who are members of the Google Groups you enter will be able to join your test.
     • Tip: To learn how to manage Google Groups, go to the G Suite Administrator Help Center.
7. Provide a feedback URL or an email address to collect feedback from testers. Your app's feedback channel will be shown to users on your tester opt-in page.
8. Copy the shareable link to share the release with testers.
9. Select Save.

Testing tips and support

When you create additional closed tracks, the following features aren't supported:

• Enterprise targeting used to publish private apps
• Device compatibility for app bundles only published via additional test tracks
• Country targeting
• Track details via the Play Console app (additional tracks will all display as Open testing tracks)

If you use Google Play games services, tester groups are automatically shared between your app and Google Play games services.

Testers can try out changes you’ve saved to your game projects, like achievements and leaderboards, before they’re published to real users. You can manage testers individually using their email address or reuse the same testers as your release tracks.

On your Play Game services > Setup and management > Testers page, you can use the testers switch to automatically include any users that are opted into testing for your app.

To manually add individual testers for Google Play games services:

1. Open Play Console and go to the Play Games Services testers page (Play Games Services > Setup and management > Testers).
2. On the left menu, select Play Game services > Setup and management > Testers.
3. Type the email addresses you'd like to add. Email addresses must be valid Google accounts that are signed in with Google Play Games Services.
4. Select Add.

Once users have opted-in to your test group, they can sign in using Google Play Games Services, earn draft or published achievements, and post to draft or published leaderboards.

Users receive the version of the app that has:

• the highest version code that’s compatible with their device, and
• been published to a track they're eligible to receive.

All users are always eligible to receive the Production track. If an app bundle with a higher version code is published in Production track than on a test track where the user opted in, the user will receive the production release.

For a user to be eligible to receive a test track, the user must:

• be included in the managed track configuration, and
• have opted into the corresponding test program

Users eligible to receive multiple tracks will receive the highest version code published on those tracks. For example, users in open testing are eligible for both the Production track and the Open testing track. Users in closed testing are eligible for both the Production track and the Closed testing track. Users in both open testing and closed testing are eligible for the Production, Open testing, and Closed testing tracks.

Users who opted into internal testing aren't eligible for open and closed testing, even if they're included as testers. These users wouldn't receive the higher version code published on those tracks and would only receive the version code published on the Internal testing track.

For more information, see Version your app.

When you're rolling out your release, you may see validation messages that note when users of a given track receive app updates from another track–known as the track's fallback status.

Fallback terms and statuses

• Shadowed: One app bundle shadows another app bundle when it serves part or all of the same device configuration and it has a higher version code.
• Promoted: All of the track's active app bundles are contained in the fallback track's active app bundles (for example, all of the active Open testing tracks app bundles are also active in production). You may see this if you first release to a testing track and then release the tested app bundles to a more stable release.
• Superseded: All of the active app bundles in a track are completely shadowed by active app bundles with higher version codes in its fallback track. None of the app bundles in the track are being used to serve users, as they all will be served by an app bundle from the fallback track. This means the testing program represented by the superseded track was abandoned.
• Partially shadowed: At least one of the active app bundles in a track is shadowed by an app bundle with a higher version code in its fallback track. This means that some of the Open testing tracks users will be served an app bundle from the Open testing track, while others may be served an app bundle from production. This is most likely an error in assigning version codes.