Update Your Salesforce Org for Your New Domain

When you deploy a My Domain, all your application URLs, including Visualforce pages, change. Ensure a smooth transition by updating references to your old URLs.

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

Make sure that you update all application URLs when deploying a My Domain. For example, the Email Notification URL option in Chatter Answers continues to send notifications with the old URLs to internal users unless you update it. For more information, see My Domain URL Formats.

We also recommend that you review your allow lists and ensure that they include the standard Salesforce domains. For details, see Allow the Required Domains in Salesforce Help.

If You Have the Following	Do the Following
API integrations into your org	Check whether the API client references the server endpoint. For the API client, use the metadataServerUrl or serverURL value returned by a login request. Don’t use a hard-coded server URL. After you deploy your My Domain, Salesforce returns the server URL containing your My Domain name. Redirect policy settings have no effect on API calls, so old calls to instance URLs continue to work. However, best practice is to use the value returned by Salesforce.
Chatter	Tell your users to update all bookmarks listed on their Chatter groups.
A custom domain, such as `https://example.com`, serving your Experience Cloud sites or Salesforce Sites	Your Experience Cloud sites and Salesforce Sites URLs changed if you enabled or disabled enhanced domains, or if you renamed your My Domain with enhanced domains. Test external integrations that reference your custom domain. If you serve the domain using a non-Salesforce host or service, review and update the domain configuration, such as CDN settings and hard-coded references to Salesforce URLs.
Custom Visualforce pages or custom apps	Replace references to the org’s instance URL with your My Domain URL. For details, search for “hard-coded references” in Salesforce Help.
Email templates	Replace references to the org’s instanced URL with your My Domain URL.
Embedded Service Deployment (Chat) widget	The code snippet generation feature only uses `.force.com` URLs at this time. If you enabled enhanced domains, instruct users of the feature to manually update the generated code snippet to use your `.my.site.com` or `*.salesforce-sites.com` URL.
Experience Cloud sites or Salesforce Sites	Your system-managed Experience Cloud sites and Salesforce Sites URLs changed if you enabled or disabled enhanced domains, or if you renamed your My Domain with enhanced domains. System-managed URLs end in .force.com, .my.salesforce-sites.com, or .my.site.com. Update external-facing links, such as publicly available Experience Cloud sites and Salesforce Sites. Update external integrations referencing your Experience Cloud sites and Salesforce Sites.
Firewalls and proxy servers that filter by hostname	Update trust settings to include all applicable URL formats for your new configuration, as described in My Domain URL Formats in Salesforce Help.
Identity providers on your login page	If your org’s login URL changed, update your identity providers with the new URL. For more information, see Salesforce as an Identity Provider in Salesforce Help. Also update the enabled Authentication Services within the Authentication Configuration settings on the My Domain Setup page.
myTrailhead	If you enabled enhanced domains: URLs for badge art stored in Salesforce changed. Update your myTrailhead modules and trails with the new badge art URLs. If the URL for your myTrailhead authentication page is an Experience Cloud site URL ending in `*.force.com`, that URL changes. Contact Salesforce Customer Support to update your myTrailhead authentication provider. If you renamed your My Domain: If your myTrailhead login URL is your My Domain login URL in the format `MyDomainName.my.salesforce.com`, contact Salesforce Customer Support to update your myTrailhead authentication provider. If enhanced domains are enabled, URLs for badge art stored in your Salesforce org changed. Update your myTrailhead modules and trails with the new badge art URLs. If enhanced domains are enabled and the URL for your myTrailhead authentication page is an Experience Cloud site URL in the format `MyDomainName.my.site.com`, contact Salesforce Customer Support to update your myTrailhead authentication provider.
Pinned Certificates	Salesforce doesn’t recommend certificate pinning. Consider updating your policies to exclude pinned certificates. Otherwise, if you changed your My Domain suffix, review your pinned certificates against your new My Domain URLs and update them as needed.
Service Cloud Voice	When you enable Service Cloud Voice, Salesforce uses your My Domain login URL to configure single sign-on to Amazon Connect. Changing your org’s My Domain name or suffix breaks that configuration and disables Voice.
Streaming API	To ensure continuity during instance refreshes and org migrations, we recommend using My Domain URLs with Streaming API. For example, replace `https://login.salesforce.com` and `https://InstanceName.salesforce.com/` with `https://MyDomainName.my.salesforce.com/`.
Third-party connected apps	Update the URLs for your org in the third-party app. If you changed your domain suffix, update all Single-Sign On connections.
Zones for Experience Cloud sites (Ideas, Answers, Chatter Answers)	Update the email notification URL. To update the URL, clear the existing URL so that the field is blank. Save the page. Then the system populates the field with your new My Domain URL.

Identity Implementation Guide

Update Your Salesforce Org for Your New Domain