--- schema_version: "1" id: 1e934c24a89adaeeddd9c0c6a85d124d5f7d8d170cceff0b6006afa666d8a649 title: Deploy My Domain Changes collection: admin version: current locale: en-us portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/domain_name_testing_and_rollout.md canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.domain_name_testing_and_rollout.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 3f91c808b637f282850d5e8ebf14812e8be351101f3ab86b2140cfe9650bf3f1 description: After you change your My Domain and Salesforce provisions those changes, deploy your org’s new My Domain. Only after you deploy your new My Domain can you test your new URLs. And your users can’t use the new My Domain URLs until you deploy the updated My Domain. products: - Salesforce Platform - Cross Cloud release: "264" --- # Deploy My Domain Changes After you change your My Domain and Salesforce provisions those changes, deploy your org’s new My Domain. Only after you deploy your new My Domain can you test your new URLs. And your users can’t use the new My Domain URLs until you deploy the updated My Domain. ### 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
![Important](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_important.png) Important When your My Domain login URL or site URL changes, authentication methods such as single sign-on (SSO) and multi-factor authentication (MFA) can stop working. Before you deploy a change to your My Domain, [preserve login access](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_login_change_preserve_access.htm&release=264.0.0&type=5 "When your My Domain or site login URL changes, two multi-factor authentication (MFA) verification methods stop working: built-in authenticators and security keys. Without those methods, single sign-on (SSO) can also stop working. To preserve admin access to Salesforce and prevent end-user frustration, verify your backup authentication methods. In preparation for your My Domain change, determine the post-deployment steps to reestablish authentication for your org, including resetting the affected verification methods for your users.") for your admins and users. Follow these guidelines when you deploy a My Domain change. - Whenever you deploy a My Domain change, the URLs that Salesforce hosts for your org change. To review the high-level steps, the recommended practices, and how to reduce the impact on your users and customers, see [Plan for a My Domain Change](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_plan.htm&release=264.0.0&type=5 "Whether you change your My Domain to update your brand, to adopt enhanced domains, or to enable partitioned domains, the URLs that Salesforce hosts for your org change. Those changes can have a large impact, and making the required updates can seem like a daunting project. To make the process as smooth as possible for you, your users, and your customers, review the high-level steps, the recommended practices, and how to reduce the impact on your users and customers."). - Test My Domain changes in a sandbox before you update production. You can’t test in production. After you deploy a My Domain change, it immediately applies to all users and third-parties that access your org. - In case you must troubleshoot any issues, we recommend that you deploy your new My Domain when your org receives minimal traffic, such as during the weekend. - When you deploy a My Domain change, active user sessions can be terminated. Similarly, any connection to Salesforce can be reset when you deploy the My Domain change. If a feature that connects to Salesforce stops working, the user can reauthenticate. For example, in Salesforce CLI, use [force:org:open](https://developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/cli_reference_force_org.htm#cli_reference_force_org_open) to log in again. - Before you deploy a My Domain change, including enabling or disabling enhanced domains, consider the impact on any existing My Domain URL redirections. Salesforce only redirects your last set of previous My Domain URLs. For more information, see [Understand Redirections for Previous My Domain Host Names](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_redirections_understand.htm&release=264.0.0&type=5 "After you deploy a change to your My Domain, Salesforce redirects your previous My Domain host names. If your org was created before Summer ’22, enhanced domains were deployed in your org and some of those redirections were temporary. And if your production org or demo org was created before Summer ’20, host names that contained your Salesforce instance could be redirected. Learn more about these redirections and how to control them."). 1. Return to the My Domain Setup page. From Setup, in the Quick Find box, enter My Domain, and then select **My Domain**. If your domain is provisioned and ready to deploy, the My Domain Setup page shows Step 3: Deploy Your New Domain. ![My Domain Settings page showing step 3](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/setup/images/my_domain_step3_deploy.png) The current domain and new domain fields show the My Domain login URL. However, Salesforce serves multiple domains for your Salesforce org. For example, if you enabled enhanced domains, the My Domain login URL doesn’t change in production, but site, Visualforce, content, and many other URLs change. For more information on the URLs that Salesforce serves for your org and the potential impact, see [My Domain URL Formats](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_app_url_changes.htm&release=264.0.0&type=5 "Your My Domain name is a subdomain used in login URL and application URLs across your Salesforce org, including sites and Visualforce pages. Understand what determines your org’s URL formats and the structure of those formats."). As part of the provisioning process for your new domain, Salesforce performs a cursory check to ensure that you have network access to the new domains. If you don’t have the required access, the My Domain page lists the URLs you can’t access. Before you can deploy your new domain, resolve these network access issues. The access issues can be temporary, such as connectivity issues stemming from a stale DNS cache. Or they can require updates to your allowlists or network configuration. To deploy your My Domain, revisit the My Domain Setup page after the access issues are resolved. If the My Domain Setup page shows Step 2: Provisioning in Progress, Salesforce is still provisioning your new domain. The provisioning process usually finishes in a few minutes, but it can take up to 24 hours. You receive an email when the process finishes. If you continue to see the Provisioning in Progress page 24 hours after submitting your My Domain name, you can click **Stop Provisioning** to stop the process. After you stop the process, wait 15 minutes, and then try registering your My Domain name again. Or you can contact Salesforce Customer Support. 2. Optionally, if you renamed your My Domain, update your My Domain settings, such as adding authentication services. For more information, see [Configure My Domain Settings](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_settings.htm&release=264.0.0&type=5 "Customize your login page with your brand and determine the user experience when they log into your Salesforce org via your My Domain."). ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_note.png) Note My Domain settings apply to your org’s deployed and provisioned domains. 3. To roll out the new My Domain to your org, click **Deploy New Domain**, and click **OK**. When you deploy your My Domain, it’s activated immediately. You can now set login policies. See [Set the My Domain Login Policy](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_setting_login_policy.htm&type=5&language=en_US). Before you test the deployed My Domain, update all URL references in your org. 4. To cancel your requested My Domain changes, click **Cancel New Domain**. ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_note.png) Note To avoid potential conflicts between follow-up processes, such as CNAME and DNS updates, you can’t make a change that requires provisioning for 15 minutes after you deploy or cancel a new My Domain. Changes that require provisioning include changing your My Domain name or suffix, enabling enhanced domains, removing a previous My Domain name, and moving to Salesforce Edge Network. Each time that you deploy a change to your My Domain, Salesforce redirects requests from your previous My Domain URLs to your current My Domain. If you don’t want those requests to be redirected, see [Disable or Remove Your Previous My Domain](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_remove_previous.htm&release=264.0.0&type=5 "Each time that you deploy a change to your My Domain, Salesforce redirects requests from your previous My Domain URLs to your current My Domain. Optionally, disable redirections from your previous My Domain. We recommend that you use that option when you test a My Domain change. Or, to use your previous My Domain in a different Salesforce org, remove your previous My Domain."). Next steps: - Review the changes to your org’s URLs in [My Domain URL Formats](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_app_url_changes.htm&release=264.0.0&type=5 "Your My Domain name is a subdomain used in login URL and application URLs across your Salesforce org, including sites and Visualforce pages. Understand what determines your org’s URL formats and the structure of those formats."). - [Update your org](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_guidelines.htm&release=264.0.0&type=5 "When you deploy a change your My Domain, your Salesforce org’s login URL and application URLs change. URLs that are dynamically constructed—for example, URLs generated via the DomainCreator Apex class—use the new URLs automatically. However, some Salesforce functionality requires an update to work with your new URLs. Similarly, custom code, your network configuration, and third-party integrations that use the old URLs require updates. To ensure a smooth transition to your new URLs, update references to your old URLs."). - [Test the changes](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_test.htm&release=264.0.0&type=5 "Follow these guidelines to test My Domain changes and to ensure a smooth transition to the new My Domain URLs."). #### See Also - [My Domain](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_overview.htm&release=264.0.0&type=5 "Showcase your company’s brand with a customer-specific subdomain name in your Salesforce org URLs. With My Domain, you can include your company name in your URLs, for example, https://mycompany.my.salesforce.com. With these org-specific URLs, you can set up a custom login page, set a custom login policy, offer single sign-on, and allow users to log in with a social account. My Domain also allows you to work in multiple Salesforce orgs in the same browser at the same time.") - [Configure My Domain Settings](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_settings.htm&release=264.0.0&type=5 "Customize your login page with your brand and determine the user experience when they log into your Salesforce org via your My Domain.")