TestBuddy Sign in

Guide

How to set up closed testing in Google Play Console

Create the app, finish its setup tasks, add testers to the Closed testing track by email list or Google Group, then roll out an Android App Bundle. Once the release is published, share the opt-in link: each tester opts in, then installs from Google Play.

Updated , 10 min read

A desktop monitor showing test tracks, linked to a phone by a cable

In short. Closed testing needs a completed app setup, a tester list (email addresses or a Google Group), and a release reviewed and published on the track. The opt-in link only appears once the app is Published, and testers in a Google Group must join the group before opting in. Menu paths below are the ones Google's Help Center uses today; Play Console labels change from time to time.

What do you need before setting up a closed test?

If your account is a personal account created after 13 November 2023, this closed test is also the one that has to carry 12 testers for 14 days before you can apply for production.

Step 1: How do you create the app in Play Console?

From Google's Create and set up your app:

  1. Open Play Console and select Home > Create app.
  2. Select a default language and enter the app name as it should appear on Google Play. You can change it later.
  3. Say whether it is an app or a game. You can change this later too.
  4. Say whether it is free or paid.
  5. Add a contact email address that Google Play users can use to reach you about the app.
  6. In Declarations, acknowledge the Developer Program Policies and US export laws declarations, and accept the Play App Signing Terms of Service.
  7. Select Create app.

Think twice before making the app paid. Google says testers must purchase paid apps when they take part in open or closed tests; only internal testers install them for free. Pricing changes also apply to every track at once.

Step 2: Which setup tasks come before closed testing?

Google's track table in App testing requirements for new personal developer accounts lists one requirement to access closed testing: "Complete app setup." The app's Dashboard lists the tasks, and each one gets a green tick when done (Set up your app on the app dashboard). They cover:

Internal testing does not wait for any of this. Google says you can start an internal test before completing app setup, with up to 100 testers, and that first uploads are available to internal testers immediately. It is a good way to check the build on real phones while you fill in the forms. Just keep your closed testers out of it: a user opted in to your internal test is not eligible for your closed test until they opt out of the internal one.

Step 3: How do you open the closed testing track?

  1. Sign in to Play Console, select your app, and go to Test and release > Testing > Closed testing.
  2. A closed testing track is already there as your initial closed test. Click Manage track on it.
  3. To create another track instead, click Create track near the top right, enter a name, and click Create track.

Google allows several closed tests and one open test at the same time. Additional closed tracks have constraints, such as no country targeting (test setup article). If you are running the test for the 12 testers requirement, keeping every tester on one track keeps the count simple to follow.

Step 4: Should you add testers by email list or Google Group?

The Testers tab of a closed track accepts either. Here is how they compare, from the test setup article:

Email listGoogle Group
Who can opt inThe addresses on the listOnly members of the group
Address formatTesters' Google Account addressesyourgroupname@googlegroups.com
LimitsUp to 200 lists, 2,000 users per list, 50 lists per trackNot stated for the default track; Google says there are no size limits on groups for additional closed tracks
Before opting inNothingThe tester must join the group first
ReuseThe same list works for future tests on any of your appsMembers are managed in Google Groups

Add testers with an email list

  1. On the Closed testing page, click Manage track, then select the Testers tab.
  2. Under Testers, click Create email list and enter a list name.
  3. Add email addresses separated by commas, or click Upload CSV file with one address per line. Uploading a CSV overwrites the addresses already on the list, and Play Console rejects CSV files saved as UTF-8 with BOM.
  4. Click Save changes, then Create.
  5. Back in the Testers section, keep Email selected and select the lists that should test this release.
  6. Enter a feedback URL or email address. It appears on your tester opt-in page.
  7. Click Save changes.

Add testers with a Google Group

  1. On the Testers tab, select Google Groups.
  2. Enter the group's address, in the format yourgroupname@googlegroups.com.
  3. Enter a feedback URL or email address.
  4. Click Save changes.

Set the list or group once, then add people to it. Google's managed publishing article says changes to how testers are configured for a track (a new list or group) are held back with your other changes, while changes to the membership of a list or group already used by a track are not.

Step 5: How do you upload the app bundle and roll out the release?

From Google's Prepare and roll out a release:

  1. Go to Test and release > Testing > Closed testing, click Manage track on your track, then Create new release near the top right. If the button is disabled, finish the outstanding tasks on your Dashboard.
  2. On a first release, follow the instructions to configure Play App Signing.
  3. Upload your app bundle, or click Add from library to reuse one you uploaded before.
  4. Name the release. The name is only visible in Play Console; Google suggests something like the build version.
  5. Enter release notes, up to 500 characters per language, between language tags such as <en-US> and </en-US>.
  6. Click Save as draft, then Next.
  7. If an Errors summary appears, open it and fix every error. Warnings do not block publishing, though Google recommends addressing them.
  8. Click Start rollout. A first release has no rollout percentage.

Depending on whether your changes need review, Play Console offers Save or Publish. Saved changes wait on the Publishing overview page until you click Send for review; Google says items are not sent for review until you do. Remember to increase versionCode for every upload: Google's ceiling for Play Console is 2100000000.

How long does a closed testing release take to review?

Google gives no separate figure for closed tests, only general ones:

Plan for a week. While you wait, internal testing keeps you moving: Google says new bundles on that track reach testers within minutes.

How do testers join a closed test and install the app?

Once the app's status is Published, go back to the Testers tab and copy the shareable link. Google says the opt-in link is not shown while the app is in Draft or Pending publication. Before your app reaches production or open testing, testers cannot find it by searching Google Play, so send them the opt-in link.

On the tester's side:

  1. If you use a Google Group, they join the group first, with the Google Account they will use on their phone.
  2. They open your opt-in link. Google shows them an explanation of tester responsibilities and a link to opt in; each tester must opt in this way.
  3. They install the app from its Google Play page.
  4. They send feedback through your channel, or privately through Google Play. Google's user help describes it: Play Store profile icon, Manage apps & devices > Beta, the app, then Write feedback, with a star rating (Try new Android apps before their official release).

Once installed, the app updates to the test version automatically within a few minutes. Testers cannot leave public reviews on a test version, and their feedback does not affect your public rating.

How do you manage testers during a closed test?

How do you connect a closed test to TestBuddy?

If your testers come from a TestBuddy wave, everything above stays the same. You describe your app, add one SDK line and a tester group, in the order TestBuddy's setup shows:

  1. Describe your app in TestBuddy: app name, package name, what testers should try, and the Closed test opt-in link field, where you paste the link from your track's Testers tab. TestBuddy checks that the link names your package.
  2. Add TestBuddy's tester group to the track's Testers tab, under Google Groups.
  3. Add the SDK. It is a Kotlin library with one dependency (the Play Install Referrer client), no AndroidX and minSdk 24. TestBuddy shows the steps for your framework (Kotlin, Flutter, React Native, Expo, Unity, Capacitor) with your app's key; no code, the key goes in the manifest:
    <meta-data android:name="com.jointestbuddy.KEY" android:value="pk_..." />
  4. Upload that build to your closed testing track, and open it once on any phone. The SDK says hello and the setup step completes.
  5. Join the next wave. First join TestBuddy's tester group yourself, with the Google account of your phone, so you can opt in to the other tests. The wave starts once 16 developers are in: your app gets 15 testers who each open it for at least 2 minutes a day for 14 days, and you test their 15 apps.

The SDK links each install to a tester through the Play install referrer and counts the time your app spends in the foreground. It has no user interface, and you can remove it before your production release.