---
schema_version: "1"
id: 1a6ff4030d2d4fb630b83579d37ccbaa0f0b35c319e70729b4a11fd3b922e535
title: Link a Namespace to a Dev Hub Org
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/platform-pkg-exchange/managed_packaging/guides/second-generation/sfdx-dev-reg-namespace.md
canonical_url: https://developer.salesforce.com/docs/platform/pkg1-dev/guide/sfdx-dev-reg-namespace.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: f5b9f470acc0b30e7b9efa72ba50729032ab8be7175b03fb6a920e0f7a79b709
products:
  - First-Generation Managed Packaging Developer Guide
  - merged-docs
---

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

## Before You Begin

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.

  **important:** 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.

1.  Log in to your Dev Hub org as the System Administrator or as a user with the Salesforce DX Namespace Registry permissions.

    **tip:** Make sure your browser allows pop-ups from your Dev Hub org.

    1.  From the App Launcher menu, select **Namespace Registries**.

    2.  Click **Link Namespace**.

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

## Next Steps

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