Update or unpublish your app

In February 2023, we made changes to your publishing workflow to make it easier to understand which changes you're sending for review. You can also better control when you send certain changes for review.

Visit the Android Developers Blog to learn more.

When you're ready to make changes to your app, this article describes what you need to do to make sure that existing users receive your update.

Prepare your updates

The package name of the updated Android App Bundle must be the same as the current version.
The version code must be greater than the current version. Go to the Android Developers site to learn more about versioning your app.
The updated app bundle must be signed with the same signature as the current version.

Confirm an app bundle's certification

To confirm that your app bundle is using the same certification as the previous version, you can run the following command on both versions and compare the results:

$ jarsigner -verify -verbose -certs my_application.aab

If the results are identical, youâ€™re using the same upload key and are ready to continue. If the results are different, you will need to re-sign the app bundle with the correct upload key.

Learn more about signing your app.

Tip: Use the App bundle explorer to easily manage your app bundles in one place.

Upload your app bundle

Once your updated artifact is ready, you can create a new release.

Delivery of updates

After youâ€™ve submitted an update to an app, youâ€™ll see â€œIn reviewâ€ under "Update status" on your app's Dashboard. Once the update is published, your update will start being distributed to existing users.

Once your update is available, users can download the update on your appâ€™s store listing page or from their My apps page on the Play Store app. If a user has turned on automatic updates for your app, the update will be downloaded and installed automatically.

Note that app updates can take some time to be delivered to existing users.

Unpublish an app

When you unpublish an app, existing users can still use your app and receive app updates, but new users won't find and download it on Google Play.

Before you can unpublish an app, you must ensure that:

You have accepted the latest Developer Distribution Agreement.
Your app has no errors that need to be addressed, such as failing to fill in the content rating questionnaire or provide details about your app's target audience and content.
Managed publishing is not active for the app that you want to unpublish.

To unpublish your app:

Open Play Console.
Select an app.
Go to Test and release > Setup > Advanced settings.
On the App Availability tab, select Unpublish.

Updating system apps

Users will see system apps (including any preloaded apps) in the My Apps section of the Google Play Store as soon as an app with the same package name is uploaded to Play Console (even if the app is unpublished).

Google Play can manage updates to preloaded apps, provided the following conditions are met:

The preloaded app needs to be in the system partition.
The preloaded app needs to be free.
The preloaded app needs to be signed with the same signature as the app published on Google Play.
The package name of the preloaded and updated app needs to be the same.
The version code of the updated app needs to be greater than that of the preloaded app.

Tip: Use the Play Developer API to download system APKs generated from app bundles that you upload to Google Play.

If you need to upload a system app and encounter an error message when doing so, please contact us.

Was this helpful?

How can we improve it?