Move a My Domain Name to a Different Org
You can’t use an existing My Domain name in a new org, even if you own the org where that name is currently in use. To make the My Domain name available for a new org, first remove the name from the old org
Required Editions
| Available in: both Salesforce Classic and Lightning Experience |
| Available in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions |
| User Permissions Needed | |
|---|---|
| To edit My Domain settings: | Customize Application |
| To define a My Domain name: | Customize Application AND Modify All Data |
When to Move a My Domain
My Domain names are unique with one exception: A production org and its sandboxes can
share the same My Domain name. Sandbox host name formats make this possible. For example, the
host name format for a production login URL is
MyDomainName.my.salesforce.com, and the host name format
for a sandbox login URL is
MyDomainName--SandboxName.sandbox.my.salesforce.com.
To make sandbox host name prefixes unique, the sandbox name is appended to the My Domain name.
When you create or refresh a sandbox, the process uses the My Domain name from the source org
and the sandbox name to set that subdomain for the sandbox host names.
Also, when you specify the My Domain name for a Developer Edition org,
-dev-ed is appended to the string that you enter in the My Domain name
field. So if the My Domain name in production is example, you can use
example-dev-ed as the My Domain name in a Developer Edition org.
Moving a My Domain name is necessary only when you want to reuse the subdomain string that includes the My Domain name. For example, when you replace a production org or a Developer Edition org.
Move a My Domain Name
To minimize the required updates after you move the My Domain name, take these steps in a new org before you configure additional features and before users access the org.
- In the old org, rename the My Domain.
For the new name, choose a string that you never intend to use as a My Domain name. See Change Your My Domain Details.
- After you deploy the new My Domain name, remove the previous My Domain from the
old org.
See Disable or Remove Your Previous My Domain.
The My Domain name that you remove is the name that you want to use in the new org.
- Wait at least 15 minutes for the changes to take effect.
- Log My Domain host
name redirections in the new org.
The Hostname Redirects Event Type captures redirected calls to the org’s previous My Domain host names.
- To collect host name redirection logs for multiple days, schedule a daily
query of the Hostname Redirects event type via REST API.For example, you can configure a cron job in Unix or a scheduled task in Windows to run the query.
- To collect host name redirection logs for multiple days, schedule a daily
query of the Hostname Redirects event type via REST API.
- In the new org, update the My Domain name.
- If users accessed the new org or if you configured features in the new org before you moved the new My Domain name, update references to your old My Domain name and URLs.
