Salesforce DX Developer Guide

How Salesforce Developer Experience Changes the Way You Work
Enable Dev Hub Features in Your Org
Project Setup
Sample Repository on GitHub
Create a Salesforce DX Project
Salesforce DX Project Structure and Source Format
How to Exclude Source When Syncing or Converting
Create a Salesforce DX Project from Existing Source
Retrieve Source from an Existing Managed Package
Retrieve Unpackaged Source Defined in a package.xml File
Convert the Metadata Source to Source Format
Salesforce DX Usernames and Orgs
Override or Add Definition File Options at the Command Line
Link a Namespace to a Dev Hub Org
Salesforce DX Project Configuration
Multiple Package Directories
Authorization
Metadata Coverage
Scratch Orgs
Sandboxes
Development
Build and Release Your App
First-Generation Managed Packages
Second-Generation Managed Packages
Unlocked Packages
Continuous Integration
Troubleshoot Salesforce DX
Limitations for Salesforce DX
PDF

Newer Version Available

This content describes an older version of this product. View Latest

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, go to Step 1.
  • 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. Once you associate a namespace with an org, you can't change it or reuse it.

    Important

  1. 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.

    Tip

  2. (Required) If you have not already done so, define and deploy a My Domain name.

    Why do you need a My Domain? A My Domain adds a subdomain to your Salesforce org URL so that it’s unique. As part of the Namespace Registry linking process, you’ll be logging into two distinct orgs simultaneously (your Dev Hub org and your Developer Edition org), and your browser can’t reliably distinguish between the two without a My Domain.

    Tip

    You receive an email when your domain name is ready for testing. It can take a few minutes.

  3. From the App Launcher menu, select Namespace Registries.
  4. Click Link Namespace.
    If you don’t see the Link Namespace button, make sure your My Domain is deployed to users.
    1. From Setup, enter My Domain in the Quick Find box, then select My Domain.
    2. Do you see the status as Domain Deployed to Users? If not, click Deploy to Users.
      Log out of your Dev Hub org, then open it again.
  5. Log in to the Developer Edition org in which your namespace is registered using the org's System Administrator's credentials.

    You cannot link orgs without a namespace, sandboxes, scratch orgs, patch orgs, and branch orgs to the Namespace Registry.

To view all the namespaces linked to the Namespace Registry, select the All Namespace Registries view.