Transfer an Unlocked Package to a Different Dev Hub

Request a Package Transfer to a Different Dev Hub

Start by logging a case with Salesforce Customer Support, and provide:

• Dev Hub org ID for the source org.
• Subscriber package ID of the package you’re transferring. This ID starts with 033.

  To verify the 033 ID of your package, run the force:package:list command with the -–verbose flag on the source Dev Hub org.

• Dev Hub org ID for the destination org.
• (Optional) Namespace of the package being transferred. If the package is a no-namespace unlocked package, skip this step.

If you’re transferring more than one package, file a separate case for each package.

After your case has been reviewed and approved, someone from Salesforce Customer Support will contact you to arrange a time to initiate the package transfer.

Prepare to Transfer Your Package

Here’s how you can help ensure a smooth package transfer.

• If the package you’re transferring has a namespace, keep the namespace linked to the source Dev Hub. Before the package transfer, the namespace must be linked to both the source and destination Dev Hub orgs.
• Before the package transfer process is initiated, ensure all push upgrades or package version creation processes have completed.
• Delete package versions that are no longer needed.
• If specified, clear the package’s Error Notification User using the sfdx force:package:update command. If you’re transferring the package to a Dev Hub org you own, you can set the Error Notification User to a user in the destination Dev Hub after the package transfer is complete.

During the Package Transfer Process

All push upgrades or package version creation processes must be complete before the package transfer process is initiated. Salesforce Customer Support will alert you about the date the package transfer will occur.

After the Package Transfer Is Complete

Run sfdx force:package:list and verify that the package is no longer associated with your Dev Hub.

Impact of Package Transfers on Package IDs

Update Your Package Project File

Before you create new packages or package versions on your Dev Hub, update your sfdx-project.json file and remove all references to the transferred package from the package directory and package alias sections.

If you have packages in your Dev Hub that depend on the package that you’re transferring, update the package dependency section in your sfdx-project.json file to explicitly specify the 04t ID of the transferred package that you depend on.

For example, if you transferred pkgA to a different Dev Hub, and your sfdx-project.json file lists the package dependency like this.

Update the dependency to either specify the 04t ID of pkgA.

Or specify the dependency using a package alias.

What Package History Is Transferred?

Regardless of whether the package transfer occurred between two Dev Hub orgs you own, or the package was transferred externally to a Dev Hub you don’t own, we transfer the package version history.

We transfer:

• Package name, namespace, type, and IDs. One exception is that the transferred package gets a new 0Ho ID.
• Package version info. This includes all the info that is typically displayed when you run the force:package:version:list or force:package:version:report command.

We don’t transfer:

• Push upgrade history.
• Package version create requests.
• The username of the Dev Hub user who received Apex and other types of error notifications. This optional user is set using --errornotificationusername.