Link a Namespace to a Dev Hub Org
To use a namespace with a scratch org, you must link the Developer Edition org where the namespace is registered to a Dev Hub org.
Complete these tasks before you link a namespace.
-
If you don’t have an org with a registered namespace, create a Developer Edition org that is separate from the Dev Hub or scratch orgs. If you already have an org with a registered namespace, you’re good to go.
-
In the Developer Edition org, create and register the namespace.
Choose namespaces carefully. If you’re trying out this feature or need a namespace for testing purposes, choose a disposable namespace. Don’t choose a namespace that you want to use in the future for a production org or some other real use case. After you associate a namespace with an org, you can’t change it or reuse it.
-
Log in to your Dev Hub org as the System Administrator or as a user with the Salesforce DX Namespace Registry permissions.
Make sure your browser allows pop-ups from your Dev Hub org.
-
From the App Launcher menu, select Namespace Registries.
-
Click Link Namespace.
-
In the window that pops up, log in to the Developer Edition org in which your namespace is registered using the org’s System Administrator’s credentials.
You can’t link orgs without a namespace: sandboxes, scratch orgs, patch orgs, and branch orgs require a namespace to be linked to the Namespace Registry.
To view all the namespaces linked to the Namespace Registry, select the All Namespace Registries list view.
See Also