Test Your New My Domain

Follow these guidelines to test your My Domain and ensure a smooth transition to the new domain.
Available in: both Salesforce Classic (not available in all orgs) and Lightning Experience
Available in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions

Before updating production, we recommend that you test deploying a My Domain in a sandbox.

Note

Your Salesforce org’s URLs are used throughout the Salesforce application, such as with API integrations, custom Visualforce pages, and custom apps. For more information, see My Domain URL Formats.

The My Domain Setup page displays your org’s current My Domain domain URL and the login URL for any My Domain change in progress. For changes to other URLs in your org, such as Visualforce pages, Salesforce Sites, and Experience Cloud sites, see My Domain URL Formats.

Tip

To prepare for testing your My Domain:
  • Update your org for your new domain by updating references to your old URLs. For more information, see Update Your Salesforce Org for Your New Domain.
  • Configure your My Domain settings, including customizing your My Domain login page and adding authentication services, such as single sign-on. While you can update these settings after you deploy, it’s better to set up and test them in a smaller environment.
  • When you test in a sandbox, note the changes required to complete successful tests. Use that list when deploying your My Domain in your production org.

Test the new My Domain by logging in to your org and clicking tabs and links. In the browser address bar, notice that the URLs to all your pages include your new My Domain subdomain. Run automated and manual tests to ensure that they pass with the My Domain deployed.

If you customized your org, for example, with buttons or Visualforce pages, make sure that you test your changes thoroughly. Look for broken links due to hard-coded references (instance-based URLs such as https://na30.salesforce.com).

If you enabled or disabled enhanced domains, or if you renamed your My Domain with enhanced domains, your Experience Cloud sites and Salesforce Sites URLs changed. Review and update external integrations referencing your Experience Cloud sites and Salesforce Sites.

If you configured Auth Providers, include connecting to each third party in your testing.

For further guidance on updating references to your My Domain URLs when you deploy or change your My Domain, see Update Your Salesforce Org for Your New Domain.

After you complete testing, help your users get started using your new My Domain by providing links to pages they use frequently, such as your login page. Let your users know if you changed the login policy, and encourage them to update their bookmarks the first time they’re redirected. If you enabled enhanced domains, update external-facing links, such as publicly available Experience Cloud sites and Salesforce Sites.