---
schema_version: "1"
id: 1f5239ada29ae4a3441168cfb67aa18e0522e02d4f1d11526a33f7d7b1db042d
title: My Domain Provisioning and Deployment
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/domain_name_setup.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.domain_name_setup.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 991248e77371cac92870063e94577c3cce49e9d31d53b6eb60c6a8c64d3cda85
description: Understand the provisioning and deployment process when you deploy a change to your org’s My Domain. Learn about how each step of the process impacts your user’s access to Salesforce and why it’s important to test these changes in a sandbox.
products:
  - Salesforce Platform
  - Cross Cloud
release: "264"
---
# My Domain Provisioning and Deployment

Understand the provisioning and deployment process when you deploy a change to your org’s My Domain. Learn about how each step of the process impacts your user’s access to Salesforce and why it’s important to test these changes in a sandbox.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: both Salesforce Classic and Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Group</strong>, <strong>Essentials</strong>, <strong>Professional</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, <strong>Unlimited</strong>, and<strong> Developer</strong> Editions</td></tr></tbody></table>

In each Salesforce org, multiple domains serve content to users. In addition to your My Domain login URL, your org has application URLs on different domains. Here are a few examples.

- Lightning pages
- Visualforce pages
- Experience Cloud sites
- Experience Builder for Digital Experiences
- Salesforce Sites
- User-stored content served by Salesforce, such as images and files

When you deploy a change to your org’s My Domain, those domains are updated. For more information about all the URLs associated with your org and their formats, see My Domain URL Formats in Salesforce Help.

## My Domain States During a Change

There are three steps to updating your My Domain: save the changes, provision the new domains, and deploy the new domains.

Let’s look at an org’s state throughout the process. Remember that a My Domain has multiple URLs associated with it, such as the login, Visualforce page, content, and Experience Cloud site URLs.

![Diagram of the four stages of a My Domain](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/setup/images/my_domain_states.png)

My Domain changes only become active (A) after they’re staged by Salesforce (B) and the admin deploys the change.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:44.44444444444444%">
          <col style="width:22.22222222222222%">
          <col style="width:33.33333333333333%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d113116e134">Step</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d113116e137">Accessible Domains</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d113116e140">Available Options</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Step" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e134 ">
              <p>No My Domain changes pending (1).</p>
              <p>To start the process, you save a change on
                the My Domain Setup page. For example, you change the My Domain name.</p>
              <p style="margin-bottom:0;">User
                connections are unaffected.</p>
            </td>

            <td data-label="Accessible Domains" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e137 ">Current My Domain URLs (My Domain
              1)</td>

            <td data-label="Available Options" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e140 ">Make a My Domain change and start the
              provisioning process.</td>

          </tr>
          <tr class="">
            <td data-label="Step" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e134 ">
              <p>Provisioning (2). </p>
              <p>After you save a
                change to your My Domain, Salesforce provisions
                the domains. In other words, we get the new My
                Domain URLs ready for activation.</p>
              <p style="margin-bottom:0;">User
                connections are unaffected.</p>
            </td>

            <td data-label="Accessible Domains" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e137 ">Current My Domain URLs (My Domain
              1)</td>

            <td data-label="Available Options" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e140 ">
              <ul>
                <li>Wait for the provisioning process to
                  complete.</li>

                <li>To cancel your My Domain change, click
                  <strong class="uicontrol">Stop Provisioning</strong>.
                </li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Step" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e134 ">
              <p>Provisioning completed (3).</p>
              <p>When the
                provisioning process is complete, the admin who
                requested the change receives an email. Your new
                My Domain URLs are ready to be
                deployed.</p>
              <p>User connections are
                unaffected.</p>
              <p style="margin-bottom:0;">If anyone visits the new My
                Domain login URL, they’re redirected to the
                original My Domain login URL. Otherwise, no one
                can access the new domains at this
                point.</p>
            </td>

            <td data-label="Accessible Domains" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e137 ">Current My Domain URLs (My Domain
              1)</td>

            <td data-label="Available Options" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e140 ">
              <ul>
                <li>To deploy your new My Domain URLs, click
                  <strong class="uicontrol">Deploy New Domain</strong>.
                </li>

                <li>To cancel your My Domain changes, click
                  <strong class="uicontrol">Cancel New Domain</strong>.
                </li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Step" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e134 ">
              <p>Changes deployed (4).</p>
              <p>The admin logs in
                to deploy the updated My Domain. The deployment
                process also updates the related domains, such as
                Visualforce pages and Experience Cloud
                sites.</p>
              <p style="margin-bottom:0;">Immediately after the My Domain is
                deployed, the new My Domain URLs are available to
                all users.</p>
            </td>

            <td data-label="Accessible Domains" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e137 ">
              <ul>
                <li>New My Domain URLs (My Domain 2)</li>

                <li>Previous My Domain URLs (My Domain 1) </li>

              </ul>
            </td>

            <td data-label="Available Options" class="slds-cell-wrap" style="vertical-align:top;" headers="d113116e140 ">
              <ul>
                <li>Disable redirections from your previous My
                  Domain (My Domain 1).</li>

                <li>Make a My Domain change and start the
                  provisioning process. </li>

              </ul>
            </td>

          </tr>
        </tbody>
      </table>

Until you deploy the changes, all users continue to use the original My Domain (My Domain 1).

When an admin deploys a new My Domain, the admin is logged out of Salesforce. Users are redirected to the new My Domain, which can require logging in again. Everyone can log in again with the new My Domain login URL or, if the My Domain settings allow it, with https://login.salesforce.com.

By default, if a user accesses one of the previous My Domain URLs through a link or bookmark, the user is redirected to the corresponding current My Domain URL.

![Diagram showing the user's primary connection is to the new My Domain, and that visits to the old My Domain are redirected to the new one.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-setup-264-0-0-production-enus/6f21df35-9ea0-4f53-ac94-45c3b5dfd5bc/setup/images/my_domain_redirect.png)

You can disable these redirections through the Redirections options on the My Domain Setup page.

## Test My Domain Changes

Did you notice something missing from the change process? When did we test the new domains and the related functionality?

Due to the nature of provisioning and deployment, both sets of domains can’t be live simultaneously. For this reason, you can’t test a My Domain change that’s provisioned but not deployed. You can only test My Domain changes after you deploy them.

When you deploy a change to your org’s My Domain, you have the option of redirecting from the previous URLs to the new URLs. Whether your users access them directly or are redirected to them, everyone accessing the org uses the new URLs. If you don’t test your My Domain change before you deploy it, your users can experience an issue in Salesforce due to the change before you learn about it. For example, if your network settings block access to one of your new domains, users can experience connectivity issues or unavailable features.

For this reason, before you update your org’s My Domain in production, we recommend that you always deploy and test the My Domain change in a sandbox. For more information, see [Update Your Org and Test My Domain Changes](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_deploy_update_test.htm&release=264.0.0&type=5 "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.").

#### 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.")
- [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.")
- [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.")
- [Update Your Org and Test My Domain Changes](https://help.salesforce.com/s/articleView?id=xcloud.domain_name_deploy_update_test.htm&release=264.0.0&type=5 "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.")