Change a site address - SharePoint in Microsoft 365 (2024)

As at least a SharePoint Administrator in your organization, you can change the URL for the following types of SharePoint sites (previously called "site collections"):

• Microsoft 365 group-connected team sites
• Modern team sites that don't belong to a Microsoft 365 group
• Communication sites
• Classic team sites

Changing the site address isn't supported in the following situations:

• The Publishing feature is currently activated or was previously activated for the site.
• The site contains more than 15 million documents.

You can change only the address of the site within the URL, for example:

https://contoso.sharepoint.com/sites/project-x
tohttps://contoso.sharepoint.com/sites/project-y

You can't move the site from "/sites" to "/teams." For info about changing your SharePoint domain name, see Change your SharePoint domain name.

It can take about 10 minutes to change the site address (depending on the size of the site), and the site is read-only during this time. We recommend changing addresses during times when site usage is low.

You can change the address of up to 100 sites at a time. To change another site address, wait for ongoing changes to finish.

Communicate the address change to users

Before you change the address of a site, it's important to communicate the change to site users (generally anyone with the ability to edit or view the site). This can help reduce user confusion and calls to your help desk. Review the effects of changing a site address and let users know the following information:

• The planned date of the change
• The planned URL
• Users should close their files and not make edits during the address change
• Users should check the site recycle bin to make sure it contains no files they want to keep
• File permissions and sharing stay the same

1. Go to Active sites in the new SharePoint admin center, and sign in with an account that has admin permissions for your organization.

   Note

   If you have Office 365 operated by 21Vianet (China), sign in to the Microsoft 365 admin center, then browse to the SharePoint admin center and open the Active sites page.

2. To open the details panel, select the site name.

3. On the General tab, under Site address, select Edit.

   

4. Enter the new site address, and then select Save.

   Note

   You can't change the address of hub sites, sites that are locked or on hold, Project Web App (PWA) sites, or sites that have BCS connections.

   When you change a site address, we create a redirect at the previous address. If you want to reuse the previous address, you need to delete the redirect. Learn how

Change site addresses by using Microsoft PowerShell

1. Download the latest SharePoint Online Management Shell.

   Note

   If you installed a previous version of the SharePoint Online Management Shell, go to Add or remove programs and uninstall "SharePoint Online Management Shell."

   See Also

   How to Enable Quick Edit in SharePoint Online?

2. Connect to SharePoint as at least a SharePoint Administrator in Microsoft 365. To learn how, see Getting started with SharePoint Online Management Shell.

3. Run the following command to verify that the site address can be changed:

   Start-SPOSiteRename -Identity https://contoso.sharepoint.com/sites/project-x -NewSiteUrl https://contoso.sharepoint.com/sites/project-y -ValidationOnly

4. Run the following command to change the site address:

   Start-SPOSiteRename -Identity https://contoso.sharepoint.com/sites/project-x -NewSiteUrl https://contoso.sharepoint.com/sites/project-y

   For more info about this cmdlet, see Start-SPOSiteRename.

Effects of changing a site address

While the change is in progress, the site is set to read-only, and a redirect is created. After the change is complete, users are redirected to the new URL if they've saved the site as a favorite, or if they select a link to the site.

Apps
If apps in your organization refer to the site's URL, you might need to republish the apps when you change the site's address.

Custom Forms Created in Power Apps
You need to recreate the Custom Form after the site address change.

Hub sites
If the site is associated with a hub, it must be reassociated after the site address is changed.

InfoPath forms
InfoPath forms that refer to URLs might not work after the site address is changed.

List View web part
If a List View web part on a page is scoped to a specific folder in that list, the web part might display an error after the site URL is changed. To fix this issue, either edit the web part and reset the folder path or remove the web part from the page, and then add it again.

Microsoft FormsIf the site is a Microsoft 365 group-connected site that has forms in Microsoft Forms, any File Upload questions in forms break. To fix this issue, recreate the file upload questions to allow responders to upload files again.

OneNoteIf users have a notebook open during the site address change, they see a notebook sync error. After the address is changed, the following OneNote apps will automatically detect and seamlessly sync notebooks to the new site URL:

• OneNote desktop app – Version 16.0.8326.2096 and later
• OneNote for Windows 10 – Version 16.0.8431.1006 and later
• OneNote mobile app – Version 16.0.8431.1011 and later

Users don't need to sign in again or take any other action.

PermissionsPeople who have permission to access the site can access the site during and after the site address change.

Recent lists inside Office appsThe Word, Excel, and PowerPoint desktop apps and apps for the web will show the new URL after the change.

Recycle binFiles in the recycle bin will be restorable as per the usual deletion timeframe.

SharePoint mobile apps for Android and iOSThe SharePoint mobile apps detect the site's new URL. Make sure that users have updated their apps to the latest version.

SharePoint web partsAny embedded URLs in any SharePoint web parts (News, List, etc.) won't be updated and may break. This includes page thumbnail images in news posts existing on the site. After the site address is changed, you might need to update individual web parts to use the new URL.

SharePoint workflow 2013SharePoint workflow 2013 will need to be republished after the site address is changed.

Sharing links
After the site address is changed, sharing links will automatically redirect to the new URL.

Site customizations and embedded codeSite customizations and embedded code that refer to URLs might need to be fixed after the site address change. Changing the site address preserves data stored in SharePoint but won't change URL dependencies in custom solutions.

Synced locationsThe OneDrive sync app will automatically detect and seamlessly transfer syncing to the new site URL after the site address has been changed. Users don't need to sign in again or take any other action. (Version 17.3.6943.0625 or later of the sync app required.)If a user updates a file while the site address is being changed, they see a message that file uploads are pending during the change.

Microsoft 365 groupsThe email address of the group won't be renamed. The group name is updated only if the site name is updated during the rename process.

Teams (for Microsoft 365 group-connected sites)When the site address change is complete, users are able to access their SharePoint files in the Teams app, with the following limitations.

Revert a site address change

If you need to change the address of a site that was previously changed, we recommend not renaming the site again. This can cause issues if you later want to use the current address for another site. Instead, we recommend returning the site back to its original address. To do so, you use an additional site rename and delete certain redirect sites. Learn how to delete redirect sites.

For a case where you changed https://contoso.sharepoint.com/sites/project-x to https://contoso.sharepoint.com/sites/project-y and want to revert back, the steps to follow are:

1. Delete the redirect from project-x to project-y by using the Remove-SPOSite cmdlet on the project-x address.
2. Initiate a new site address change from project-y to project-x.
3. Delete the redirect from project-y to project-x by using the Remove-SPOSite cmdlet on the project-y address.

After following these steps, you should be back to the original state before the site address change.