Search
Clear search
Close search
Google apps
Main menu

Release app updates with staged rollouts

You can release an APK 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, not when publishing an app for the first time.

User eligibility & targeting

  • New and existing users are eligible to receive updates from staged rollouts and are chosen at random.
  • When setting up a staged rollout, you can't target specific users, device types, OS versions, etc.
  • When you increase the percentage of a staged rollout, your original group of users is always included. If you upload a new APK to an existing staged rollout, your original group receives the update. When you create a brand new staged rollout, your staged rollout starts with a new user group.
  • 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.

Set up & maintain a staged rollout

Set up a staged rollout of an APK you have in alpha or beta testing
  1. Sign in to your Google Play Developer Console.
  2. Select an app.
  3. On the left menu, click APK > Alpha Testing or Beta Testing.
  4. Promote your APK to Production. If needed, deactivate your previous production APK.
  5. On the Production tab, next to "APK" and the Publish Now button, click the down arrow Drop-down arrow.
  6. Select Publish as staged rollout.
  7. Select a percentage.
  8. Click Save and publish.
Set up a staged rollout on production (without an alpha or beta test)
  1. Sign in to your Google Play Developer Console.
  2. Select an app.
  3. On the left menu, click APK > Production.
  4. Select Upload new APK to production.
  5. Next to Save Draft, click the down arrow Drop-down arrow.
  6. Select Publish as staged rollout.
  7. Select a percentage.
  8. Click Save and publish.
Increase your staged rollout percentage
  1. Sign in to your Google Play Developer Console.
  2. Select an app.
  3. On the left menu, click APK > Production > Increase percentage.
  4. Select a percentage.
  5. Click Save and publish.
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 play.google.com/apps/publish

  1. Sign in to your Google Play Developer Console.
  2. Select an app.
  3. On the left menu, click APK > Production.
  4. Look for the "Staged Rollout" section and click Halt staged rollout > Halt.

Halt using the Play Console app

  1. Open the Play Console app Console app.
  2. Select an app.
  3. Tap the "Active distribution channels" card.
  4. Tap Staged rollout > Halt rollout > Halt.
Resume a staged rollout with a new APK

You can resume a halted staged rollout by uploading a new APK that fixes the issue to production and publishing your staged rollout to the same percentage of users. Your rollout will resume using the new APK. This can help minimize the number of users who had issues with your previous version.

Simple mode

  1. Sign in to your Google Play Developer Console.
  2. Select an app.
  3. On the left menu, click APK > Production > Upload new APK to production.
  4. Upload your APK.
  5. Click Publish now to production.

Advanced mode

  1. Sign in to your Google Play Developer Console.
  2. Select an app.
  3. On the left menu, click APK > Production > Upload new APK to production. Upload additional APK files to production as needed for your multiple APK configuration before publishing.
  4. Upload your APK.
  5. Click Save draft. You'll see a checkbox for "Resume staged rollout when republished" automatically checked.
  6. Click Publish now.
Resume a staged rollout with the same APK

You can resume a halted staged rollout without making changes to your APK if you find your existing APK doesn’t have any issues.

Simple mode

  1. Sign in to your Google Play Developer Console.
  2. Select an app.
  3. On the left menu, click APK > Production.
  4. Look for the "Staged Rollout" section and click Resume staged rollout.

Advanced mode

  1. Sign in to your Google Play Developer Console.
  2. Select an app.
  3. On the left menu, click APK > Production.
  4. Look for the "Staged Rollout" section and check the box for "Resume staged rollout when republished."
  5. Click Publish now.

Using the Play Console app

  1. Open the Play Console app Console app.
  2. Select an app.
  3. Tap the "Active distribution channels" card.
  4. Tap Staged rollout > Resume rollout > Resume.

Tips for live staged rollouts

  • While a staged rollout is in progress, you won't be able to update your production configuration. Before you can update your production configuration, you need to publish the staged rollout to 100% of users.
  • We recommend updating your Store Listing after your staged rollout reaches 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 Developer Console.
  • You can update a staged rollout without halting by following the steps under resume a staged rollout with a new APK.

Was this article helpful?
How can we improve it?