Search
Clear search
Close search
Google apps
Main menu
true

Release app updates with staged rollouts

You can release an app update to production using a staged rollout. With a staged rollout, your update reaches only a percentage of your users, which you can increase over time.

Staged rollouts can only be used for app updates to production, not when publishing an app for the first time or creating an alpha or beta release.

User eligibility & targeting

  • New and existing users are eligible to receive updates from staged rollouts and are chosen at random for each new release rollout.
  • When setting up a staged rollout, you can't target specific users, device types, OS versions, etc.
  • When you halt and then resume the rollout of your release, you'll be affecting the same set of users.
  • When you do a staged rollout of a new release before completing the rollout of the previous release, the new release will use the same group of users as the previous release (depending on the percentage of the rollout).
  • Your app update will be available to the percentage of users in your staged rollout, but it may take time for the full group to receive the update.
  • Users won't be notified if they receive a version of your app in a staged rollout.
  • If you choose specific countries for your staged rollout, the upgrade will be limited to users with Google Play accounts in those locations.

Set up & maintain a staged rollout

Select staged rollout percentage

When you rollout a production release, you'll select the percentage of users who will receive your rollout. For more information, go to prepare & rollout releases.

Release a staged rollout to specific countries

When you're releasing an app using a staged rollout, you can start with a limited set of countries.

  • By default, your staged rollout country availability matches the locations you've set up for your app's production track.
  • Once a staged rollout has started, you can't remove any countries.

To set up country targeting:

  1. Sign in to your Play Console.
  2. Select an app.
  3. On the left menu, click Release management > App releases.
  4. For the release you want to update, select Edit release.
  5. At the bottom of your screen, find the "Rollout countries" section.
  6. Select the down arrow .
  7. Select the countries where you'd like to start the rollout.
Increase your staged rollout percentage
  1. Sign in to your Play Console.
  2. Select an app.
  3. On the left menu, click Release management > App releases.
  4. For the release you want to update, select Update rollout.
  5. Select a percentage.
  6. Click Update rollout.
Halt a staged rollout

If you discover an issue, you can halt a staged rollout to help minimize the number of users who experience the issue with your app.

When you halt a staged rollout, no additional users will receive the app version in your existing staged rollout. Users who already received the app version in your staged rollout version will remain on that version.

Halt using the Play Console website

  1. Sign in to your Play Console.
  2. Select an app.
  3. On the left menu, click Release management > App releases.
  4. For the release you want to halt, select Halt rollout > Halt.

Halt using the Play Console app

  1. Open the Play Console app Console app.
  2. Select an app.
  3. On the "Active releases" card, tap Production.
  4. Tap Staged rollout > Halt rollout > Halt.
Resume a staged rollout

If you find your existing APK doesn't have any issues, you can resume a halted staged rollout.

Using the Play Console website

  1. Sign in to your Play Console.
  2. Select an app.
  3. On the left menu, click Release management > App releases.
  4. For the release you want to resume, click Resume rollout.
  5. Select a percentage.
  6. Click Update.

Using the Play Console app

  1. Open the Play Console app Console app.
  2. Select an app.
  3. On the "Active releases" card, tap Production.
  4. Tap Staged rollout > Resume rollout > Resume.

Tip: If you find an issue with your existing APK, create and rollout a new release with the fixed APK.

Tips for live staged rollouts

  • If your app update requires changes to the store listing, we recommend updating your store listing after your release rolls outs to 100% of users.
  • During a staged rollout, it's a good idea to closely monitor crash reports and user feedback. Users receiving the staged rollout can leave public reviews on Google Play. Learn how to view your ratings & reviews with the Play Console.

Was this article helpful?
How can we improve it?