Update Your Org and Test My Domain Changes

Before you deploy a change to your My Domain, work with your users to preserve their login access to your org. To test My Domain changes, deploy the change in a sandbox. If your My Domain login URL or site URL changes, update authentication. Review and make the required updates to support the new domains. Then test access to your org and your functional workflows in Salesforce. After you complete testing in a sandbox, use the same process to update your production org. Finally, update redirection behavior for your old URLs.

Required Editions

Available in: both Salesforce Classic and Lightning Experience

Available in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions

Note Whether you change your My Domain to update your brand or to adopt enhanced domains, 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 in Salesforce Help.

• Preserve Login Access During a My Domain Login URL Change
  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.
• 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.
• Update Authentication After a My Domain Change
  Determine whether your My Domain change requires that you update your authentication settings. Then learn about the authentication settings that can be impacted after a My Domain change and make the required updates. If your My Domain login host name or sites host name changed when you deployed a My Domain change, update your authentication settings.
• Update Your Org for My Domain Changes
  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 My Domain Changes
  Follow these guidelines to test My Domain changes and to ensure a smooth transition to the new My Domain URLs.