Add, remove, and search for testers in App Distribution


This document describes how to add and remove testers in App Distribution, including the following tasks:

Add, remove, and search for testers in a Firebase project

The search function lets you check for specific testers that you have added to your Firebase project. If you have a large number of testers, you can quickly search for individual testers, by their email address or name, using the search bar at the top of the group's page. Note that the search function requires that you know the email address or name of the tester that you are searching for.

You can add, remove, and search for testers in the Testers & Groups tab of the App Distribution page in the Firebase console.

To add a tester from the Testers & Groups tab to your Firebase project:

  1. Click the Add tester button next to the search bar.
  2. Enter the tester's email address.
  3. Click Add tester.

Your tester is now added to your Firebase project. To give the tester access to a release, add the individual tester to a release or add the tester to a group that has access to a release.

Tester limits

Firebase App Distribution has the following tester limits:

  • Add a maximum of 500 testers to a Firebase project

  • Add a maximum of 200 testers to an App Distribution group

To add more testers, request a no-cost limit increase.

Add and remove testers with the Firebase App Distribution API

You can use the testers.batchAdd and testers.batchRemove endpoints in the Firebase App Distribution API to add or remove testers from App Distribution using an HTTP request to the App Distribution API.

Add, remove, and search for testers from a group

The search function lets you check for specific testers that you have added to a group. If you have a large number of groups, you can quickly search for individual testers, by their email address or name, using the search bar at the top of the group's page. Note that the search function requires that you know the email address or name of the tester that you are searching for.

You can add, remove, and search for testers from groups in the Testers & Groups tab of the App Distribution page in the Firebase console. Groups are useful for managing access to releases for a large number of testers. For example, you could create a group to grant a small group of testers access to an early release of an app. Once you implement feedback from the initial tester group, you can create a group for a larger number of testers.

To add a tester to a specific group, follow these steps:

  1. Click the group's name.
  2. Click the Add testers button next to the search bar.
  3. Enter the tester's email address.
  4. Click Add tester.

When you add or remove testers from a group, those testers gain or lose access to all of the releases which were distributed to that group.

Remove a tester from a group

When you remove a tester from a group:

  • The tester is removed from all releases that they had access to exclusively via the group from which they were removed.
  • If the tester is a member of a different group which also has access to a release, the tester retains access to that release.

Delete a group

When you delete a group, all of the testers in that group are removed from all releases that they had access to exclusively via that group. In most cases, group deletion occurs almost immediately; but if you have a large number of testers and releases, the group delete can take longer. After you delete a group, it is no longer listed in the App Distribution page of the Firebase console.

Deleting a group may not take effect immediately; after you delete a group you might temporarily see individual testers from the deleted group listed as having access to a specific release.

Next steps