--- schema_version: "1" id: f51bc4c25fb0be56921a678abfea70d4259555b610ed96512a8fd5702a044ac8 title: Test 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_test.md canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.domain_name_test.htm&release=264.0.0&type=5 source_site: help.salesforce.com content_type: documentation content_hash: 3d80aba03b329bd8cd75275619b319a0ab82569d8077a97373f0739e91b38c5d description: Follow these guidelines to test My Domain changes and to ensure a smooth transition to the new My Domain URLs. products: - Salesforce Platform - Cross Cloud release: "264" --- # Test My Domain Changes Follow these guidelines to test My Domain changes and to ensure a smooth transition to the new My Domain URLs. ### Required Editions
Available in: both Salesforce Classic and Lightning Experience
Available in: Group, Essentials, Professional, Enterprise, Performance, Unlimited, and Developer Editions
## Test in a Sandbox My Domain changes affect Salesforce login URLs, application URLs, and external-facing URLs such as Experience Cloud sites, Visualforce pages, and content files. To avoid end-user disruption, before you update production, it’s important that you test My Domain changes in a sandbox. When you test in a sandbox, note the changes required to complete successful tests. Use that list to update your org when you make the same My Domain changes in production. ![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 When you enable and deploy enhanced domains in a sandbox, your My Domain login URL and the URLs for your Lightning pages and Lightning container components change. These URLs don’t change when you enable and deploy enhanced domains in production unless you also change your My Domain name or suffix. Need a refresher on sandboxes? See [Sandboxes: Staging Environments for Customizing and Testing](https://help.salesforce.com/s/articleView?id=platform.deploy_sandboxes_parent.htm&type=5&language=en_US). ## Update Your Org and Network Settings When you change your My Domain details, your org’s login URL and application URLs can change. URLs that are dynamically constructed by Salesforce use the new URLs automatically, but some Salesforce functionality requires more steps. Similarly, Apex code, JavaScript code, your network configuration, and existing data that contain the old URLs aren’t automatically updated. Ensure a smooth transition by updating references to your old URLs. For example, update your allowlists, custom Visualforce pages, the endpoint for API integration, and your identity providers with your new My Domain URLs. For more information, see [Update Your Org for My Domain Changes](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."). ## Disable Redirections During Testing When you rename your My Domain, Salesforce redirects your previous My Domain URLs to your current My Domain. To identify any issues with access to your new My Domain URLs, we recommend that you disable all redirection options during your testing. To help your users transition to your new My Domain URLs, you can enable these redirections again after you complete your testing. For more information, see [My Domain Redirections](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_redirections.htm&release=264.0.0&type=5 "When you deploy a change to your My Domain, Salesforce redirects multiple host names automatically. Learn about the types of redirections, how to log redirections for the host names that Salesforce hosts for your org, and how you can control these redirections."). ## Configure My Domain Policy Changes The My Domain login policy determines whether users and SOAP APIs can use instanced URLs such as https://na139.salesforce.com to access your org in addition to the My Domain login URL. ![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 This policy applies to all deployed and provisioned domains in the org. For more information, 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). ## Configure My Domain Settings My Domain settings determine the user experience when logging into your Salesforce org via your My Domain. For example, you can customize your My Domain login page and add authentication services such as single sign-on (SSO). You can update these settings after you roll your domain changes, but it’s better to set up and test them with your other My Domain changes. 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."). ## Prepare for Testing Your Salesforce org’s login and application URLs are used throughout Salesforce. For example, these URLs are used for API integrations, Experience Cloud sites, custom Visualforce pages, and custom apps. For more information, see My Domain URL Formats. ![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_tip.png) Tip The My Domain Setup page shows your org’s current My Domain login URL and the login URL for any My Domain change in progress. For the formats of the other URLs in your org, such as Visualforce pages, Salesforce Sites, and Experience Cloud sites, 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."). If you enabled enhanced domains, or if you renamed your My Domain in an org with enhanced domains enabled, the URLs for Experience Cloud sites and Salesforce Sites change. Include verification of these external-facing URLs from all access points in your test plans. For example, a site URL can be used on your website, social media pages, marketing materials, and templates such as email signatures and automated responses. To supplement your test plans, consider including users and partners in your testing. End-user testing can help validate the most commonly used workflows. And partners can help identify and remediate access issues efficiently. ## Conduct Functional, End-User, and Integration Testing Run automated and manual tests to ensure that they pass with your updated My Domain. Automated tests can identify issues with accessing your org. However, these tests can miss items like broken links or content on a Visualforce page. To test for these issues, log in to Salesforce, and click tabs and links. To test your external-facing links, such as Experience Cloud sites, validate access from all available points as each user type. Then work with partners to validate integrations. In your functional, end-user, and integration tests, include these common uses for Salesforce URLs. - The end-user login process, including multi-factor authentication. - Your custom My Domain login page. - Integration access to your org, such as API calls, Apex code, and external apps and systems that access your Salesforce data or provide data to your org. Also include calls made via external client apps, Lightning Out (beta), and Embedded Service Deployment (Chat). - Computer-Telephony Integrations (CTIs), such as Salesforce Call Center, Service Cloud Voice, and Click to Dial - External-facing sites, such as Experience Cloud sites, as authenticated and unauthenticated guest users. - Custom domains, such as https://www.example.com, that serve your Experience Cloud sites and Salesforce Sites. - External integrations that reference your custom domains. - If you have IP restrictions in place and you enabled enhanced domains, test access to your Experience Cloud sites and any custom domains that serve them via IPv6. - SSO for your Salesforce org and your Experience Cloud sites. - SAML SSO between your orgs and Experience Cloud sites. - If you allow users to authenticate using alternate identity provider options directly from your My Domain login page, verify that login process with each available provider. Similarly, test all browser-based authentication methods for mobile users, if available in your org. - If you configured a Salesforce authentication provider, your users can log in to your custom external web app using their Salesforce credentials. Verify that login process with each external web app. - 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. For example, look for instance-based URLs such as https://na139.salesforce.com. ![Tip](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/images/icon_tip.png) Tip To search your Salesforce code, download the metadata. Then use a command-line interface such as [Salesforce CLI](https://developer.salesforce.com/docs/atlas.en-us.sfdx_setup.meta/sfdx_setup/sfdx_setup_intro.htm). - Content stored in Salesforce, such as images and files. Multiple places can reference this content, including Visualforce pages, Experience Cloud sites, Salesforce Sites, and enablement sites (myTrailhead). - Links to your Salesforce org from your sites, such as links to content, reports, files, and other sites. ## Test Installed Packages If you installed packages from [AppExchange](https://appexchange.salesforce.com/), include the package-delivered functionality and components in your testing. Focus on components with links. For example, a package-delivered Visualforce page can contain links to your sites, content, or other Visualforce pages. ![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 In most cases, you can’t edit package-delivered components. If you find that you can edit a package-delivered component, don’t edit the component directly. Otherwise, the next package update can overwrite your changes. We recommend that package developers use generated host names and relative paths to build any links. If they follow that approach, updated links work after a My Domain change, such as enabling enhanced domains. If you find an issue with components or functionality delivered by a package from AppExchange, contact the package developer. Make them aware of the issue so that they can publish a new version of their package that remediates the issue. ## Test Again in Production Before making My Domain changes in production, we highly recommend that you test those changes in a sandbox. Ideally, your sandbox includes all the functionality of production, but there can be obvious and not so obvious differences with production. For example, not all integration with third-party applications is available in sandboxes. And some data types, workflows, or complex test scenarios can only be tested in production. As a result, after you deploy a My Domain change in production, we recommend that you perform another round of testing. ## Next Steps After you complete testing, help your users get started using your new My Domain by providing links to pages that 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 that they’re redirected. If you enabled enhanced domains, update external-facing links such as publicly available Experience Cloud sites and Salesforce Sites. For example, a site URL can be used on your website, social media pages, marketing materials, and templates such as email signatures and automated responses. Create a plan to update each location, and announce the change to your users and customers. #### 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.") - [_Knowledge Article_: Updating Hard-Coded References](https://help.salesforce.com/articleView?id=000335670&type=1&mode=1&language=en_US)