Technical Q&A QA1726

Resolving the Potential Loss of Keychain Access warning

Q:  How do I resolve the Potential Loss of Keychain Access warning?


Potential Loss of Keychain Access. The previous version of software has an application-identifier value of '' and the new version of software being submitted has an application-identifier of ''. This will result in a loss of keychain access.

This warning indicates that the App ID prefix of the pending submission differs from the App ID prefix of the live app in the app store.

Apps that should expect this warning and proceed with the submission regardless are:

  1. Those that are migrating their App ID prefix from an arbitrary Bundle Seed ID to their more-modern Team ID as documented in Technical Note TN2311 - Managing Multiple App ID Prefixes.

  2. Those that are submitting the first update for a recently acquired app via App Transfer.

For apps that do utilize technologies that rely on the App ID prefix, this warning should not be ignored. The Potential Loss of Keychain Access warning is an indication that the app was code signed with the wrong provisioning profile.

To resolve the problem:

  1. You must locate or re-create a provisioning profile that uses the correct App ID prefix on the Certs IDs & Profiles website.

  2. Click Edit on the profile to be certain the prefix is correct.

  3. Click Download and save the profile to disk.

  4. Optionally double check the App ID Prefix on the downloaded profile using the Terminal command in: How do I check the entitlements associated with my Provisioning Profile?

  5. Drag the profile onto the Xcode icon on your Dock to install it.

  6. Re-submit the app and code sign it with the newly restored profile that is associated with the right prefix.

"Keychain access" refers to all the functions in the Keychain Services Reference.

Document Revision History


Cover App Transfer expectations.


Editorial update.


New document that walks thru resolving the Potential Loss of Keychain Access warning.