How to change your SharePoint domain name?

If your organization has gone through a rebranding, merger, or acquisition and needs to change the domain in your SharePoint and OneDrive URLs, you can now do this using PowerShell. For example, if your organization name changed from Contoso to Fabrikam, you can now change your SharePoint URLs from contoso.sharepoint.com to fabrikam.sharepoint.com.

How to change your SharePoint domain name?

Step 1: Add the new domain name

1. Check the availability of the new domain you want.

For example, if you want your SharePoint and OneDrive URLs to begin with fabrikam.sharepoint.com, enter https://fabrikam.sharepoint.com in a browser. If you get a message that the address couldn’t be found (404), it’s probably available. If you get a sign-in screen or a message that your username couldn’t be found in the fabrikam.sharepoint.com directory, then the domain has already been taken and you’ll need to try a different one. If the domain is already registered by another customer, we can’t provide any information or contact the customer.

-or-

If you own the domain for another subscription, you need to delete that tenant in Azure AD. Deleting a tenant typically takes three days to complete and to make the domain available.

2. Go to https://aka.ms/SPORenameAddDomain

You must use the link https://aka.ms/SPORenameAddDomain to go to the Custom domain names page in the Azure AD admin center. If you browse to the page instead of using the link, you won’t be able to add your custom onmicrosoft.com domain successfully.

3. Select Add custom domain.

4. In the Custom domain name box, enter the full new “.onmicrosoft.com” domain, and then select Add domain. If you get a message that the domain isn’t available, try a different domain.

5. After getting a confirmation that the domain was added successfully, you might see a message that the properties could not be found. Select the message to refresh domain references.

Step 2: Use Microsoft PowerShell to rename your domain

1. REQUIRED – Download the latest SharePoint Online Management Shell.

2. Connect to SharePoint as a global admin or SharePoint admin in Microsoft 365. To learn how, see Getting started with SharePoint Online Management Shell.

Example:

Connect-SPOService -Url "https://contoso-admin.sharepoint.com"

3. Run the following command to specify the new domain name:

Start-SPOTenantRename -DomainName <DomainName> -ScheduledDateTime <YYYY-MM-DDTHH:MM:SS> [-WhatIf] [-Confirm]

Where “DomainName” is the part before “sharepoint.com” or “onmicrosoft.com” and “ScheduledDateTime” is at least 24 hours in the future, but not more than 30 days. The time you enter is based on the current date and time of the computer you’re using.

Example:

Start-SPOTenantRename -DomainName "fabrikam" -ScheduledDateTime "2021-12-31T10:25:00"

To verify success of the rename operation, please ensure that you review the status of the rename operation, as well as the count of renamed sites in comparison to total sites. The count of sites that cannot be renamed to the new domain will be shown in the Attention Required field. To get more information on these sites, run Get-SPOSiteRenameState and pass the RenameJobID listed in the tenant rename status as the ParentOperationID, and the desired status (Success/Failed/Suspended). If you want to export these results to a CSV file, you can use the Export-Csv cmdlet.