In this article
If your app uses Play App Signing and you lost its upload key, Google provides an upload-key reset path. If you lost the app signing key for an app outside that arrangement, the situation is different. Identify the missing material and enrollment status before generating a replacement or changing the package name.
Android's app signing documentation, checked October 8, 2026, explains the difference between the upload key and the app signing key. This guide does not perform a reset or request private key material.
Establish what is actually missing#
Collect the application's package name, Play App Signing enrollment state and the public certificate fingerprints shown in the Console. Compare those with the certificate associated with the keystore your build uses.
A private key, a keystore password and an alias are different things. A “wrong key” upload rejection can mean CI selected another existing keystore; it does not necessarily mean the expected key was lost.
Keep the investigation private. Public certificate fingerprints can help compare identities, but keystore files, passwords and private keys should never appear in support posts or build logs.
Choose the correct recovery branch#
With Play App Signing, Google manages the app signing key used for distributed APKs, while your upload key authenticates submitted bundles. Google's documentation says a lost or compromised upload key can be reset without replacing the app's signing identity.
For an app not enrolled in Play App Signing, losing the app signing key can remove the ability to update that app. Do not present the upload-key reset procedure as a universal recovery method for every store and enrollment arrangement.
If the key may have been exposed rather than merely misplaced, follow your organization's incident procedure as well as the provider's reset process. Replacing one CI file does not establish that every leaked copy is gone.
Prepare a controlled reset#
Use the account owner's authorized Console path and Google's current instructions for generating and registering a new upload certificate. Separate the public certificate submitted for the reset from the new private key stored in your secret system.
Record who requested the reset, the expected certificate fingerprint and the provider's completion or effective-time notice. Do not declare the reset active merely because the request was submitted.
Until the provider confirms the new identity, avoid replacing every pipeline's working configuration. A premature change can create a second outage and obscure whether the reset itself completed.
Update CI after confirmation#
Replace the relevant keystore secret, password and alias through your existing protected configuration workflow. Verify the selected certificate locally without exposing private material. Check every release workflow and branch that can upload the app; an overlooked older workflow may keep using the previous identity.
Build a controlled non-production release where your normal testing process permits it. Confirm the package and version code, then inspect the bundle signature and perform the authorized upload. Keep the new artifact and Console acceptance evidence together.
Preserve the application's history#
Do not create a new package or listing as a shortcut to an ordinary upload-key reset. That would change the product identity rather than repair its upload authentication.
Retain the provider's reset record and update the team's recovery documentation. Store recoverable copies according to your security policy and verify that authorized operators can retrieve them. Our backup versus synchronization guide explains why a synchronized folder alone is not a complete recovery strategy.