Overview of app transfer

Apps that offer auto-renewable subscriptions must use an app-specific shared secret.

• Initiate an app transfer

  Before initiating a transfer for an app that offers auto-renewable subscriptions, generate an app-specific shared secret. Then, share the code with the user of the developer account you're transferring the app to. After sharing the code, initiate the app transfer.

• Accept an app transfer

  Before you accept an app transfer for an app that offers auto-renewable subscriptions, obtain the app-specific shared secret from the initiator, so that you can update your servers to use the code to verify auto-renewable subscriptions. Once the app transfer is complete, generate an app-specific shared secret so that users outside of your organization no longer have access to it.

Keychain sharing continues to work only until the app is updated. Therefore, you must rebuild the keychain when submitting updates. If your keychain group is defined in the Xcode project, replace it with a group created by the recipient, incorporating their Team ID for continued keychain sharing. After the update, users must re-login once as the app cannot retrieve the authentication token from the keychain.

You must manually reestablish push notification services if transferring an app that uses the Apple Push Notifications service (APNs). The recipient must create a new client SSL certificate using their developer account, as associated client SSL certificates, TLS certificates, and authentication tokens aren’t transferred..

If you transfer an app that uses Apple Pay, the merchant ID isn't transferred along with the app. Transactions continue to be successful as long as the original certificates are valid. However, when you submit an update, a new merchant ID must be created on the recipient’s account.

As part of preparing your data for the recipient before the transfer, you'll need to generate a transfer identifier for each user in your database. You can do this through a REST service endpoint provided by Apple.

If you have grouped your apps for Sign in with Apple, you'll need to ungroup them before initiating the transfer.

When you transfer an app configured with "Sign in with Apple," the associated Service ID will also transfer. If you want to avoid transferring the Service ID, you must remove its association before you start the transfer process.

If your app distributes Wallet passes that require updates from your app or web service, you will need to reissue these passes with a new identifier after the transfer. The new identifiers ensure that the passes are signed with certificates from your Apple Developer account. To minimize user confusion and avoid interruption, we recommend providing a message in your app to let users know that their previously issued pass will become inactive and to download a new pass from your app or web service.

Learn about distributing, updating, and accepting passes.

Learn about best practices for setting alerts.

If your app uses any of the following, it will be transferred to the transfer recipient after they accept the app transfer.

• iCloud to store user data

• iCloud containers

• KVS identifiers associated with the app

When you transfer an app that shares a CloudKit container with other apps on your account, the transfer will impact those apps. Other apps will lose their ability to read or store data in the transferred CloudKit container. Additionally, the transferor will no longer have access to user data for the transferred app through the iCloud dashboard. Any app updates will disable the app’s ability to read or store data using the transferred CloudKit container.

If your app uses iCloud Key-Value Storage (KVS), the full KVS value will be embedded in any new provisioning profiles you create for the transferred app. Update your entitlements plist with the full KVS value in your provisioning profile.

Learn about building apps using CloudKit.

Multiplayer Compatibility: Apps that are part of a cross-app multiplayer compatibility matrix are no longer compatible with or appear in the other app’s matrix. Once the app transfers, the recipient must add multiplayer compatibility to the app in order for it to work with their existing apps.

Game Center Groups: Apps that are part of a Game Center group are removed from the group during the transfer. After the transfer, all leaderboards and achievements revert to their original status. Leaderboards that were originally a group leaderboard retain the grp. prefix in their identifier. After the transfer is complete, the recipient can add the app to the Game Center groups.

Merged Leaderboards: Leaderboards that were originally single leaderboards but were merged into a group lose the grp.prefix after transfer. They'll revert to their original leaderboard IDs before the merge. After the app transfer, the recipient must update the app build with the new leaderboard IDs so that scores post correctly.

Matchmaking: Matchmaking configuration isn’t transferred along with the app. For Game Center matchmaking to work, matchmaking rules must be created or modified on the recipient’s side after transfer is complete.

Before initiating a transfer, the transferor should notify any impacted alternative app marketplaces about the transfer of the app. Both the transferor and recipient are responsible for notifying marketplaces of any changes.

If you’re transferring an app that’s distributed on an alternative app marketplace, the recipient must have signed the Alternative Terms Addendum for Apps in the EU and have the same marketplace added in App Store Connect before the transfer for the app to remain available for download. Transferred apps are only available on alternative app marketplaces that were added in App Store Connect by both the transferor and recipient before the transfer.

Nominations can't be transferred. If you wish to share nomination details with the recipient, please document your current nominations and provide them to the recipient directly before initiating the transfer.

Learn more about nominating your app for featuring.

When you transfer an app that is part of an app bundle, you can no longer view your app bundle’s history. It’s important to make a record of your app bundle information before you transfer the app.

If you indicate support for accessibility features for your app or include an accessibility URL, these support details and the URL will transfer to the recipient. After the transfer is complete, the recipient may want to update the accessibility URL to their own website.

If you have webhooks configured for your app, they will transfer to the recipient. If you don’t want webhook events delivered to your web server after the transfer, delete the webhooks before you transfer the app. Alternatively, the recipient can update the webhooks to their own web server after the transfer is complete.