Modernize your root site

When Microsoft SharePoint is set up for an organization, a root (or top-level) site is created. Before April 2019, the site was created as a classic team site. Now, a communication site is set up as the root site for new organizations. If your environment was set up before April 2019, you can modernize your root site in three ways:

Important

Before you launch an intranet landing page at your root site location, we strongly encourage you to review the guidance about launching healthy portals.
Some functionality is introduced gradually to organizations that have opted in to the Targeted release option in Microsoft 365. This means that you might not yet see some features described in this article, or they might look different.

What's the root site?

The root site for your organization is one of the sites that's provisioned automatically when you purchase and set up a Microsoft 365 or Microsoft 365 plan that includes SharePoint. The URL of this site is typically contoso.sharepoint.com, the default name is "Communication site," and the owner is Company Administrator (all Global Administrators in the organization). The root site can't be connected to a Microsoft 365 group.

Warning

The root (top-level) site for your organization can't be deleted. If you're a Global Administrator or SharePoint Administrator in Microsoft 365, you can replace the root site with a different site.

Replace your root site

Before you begin, make sure you:

  1. Note any "Featured links" that have been added on the SharePoint start page. You'll need to add them again after you replace the root site. Learn how
  2. Review your source site to make sure it has the same policies, permissions, and external sharing settings as your current root site.
  3. Communicate the upcoming change to users. This can help reduce user confusion and calls to your help desk. If users are using files on the sites you're replacing, ask them to close the files and check the site recycle bin to make sure it contains no files they want to keep.

By default, a site redirect will be created that will redirect traffic from the source site to the root site. For info about site redirects, see Manage site redirects.

If you've turned on audit log search, the following events can be recorded:

  • Scheduled site swap: A site replacement (swap) was scheduled at this time
  • Swapped site: A site replacement (swap) completed successfully at this time
  • Failed site swap: A site replacement (swap) failed at this time and won't be tried again

Limitations

  • The site you select as the new root site must be a communication site (SITEPAGEPUBLISHING#0) or a modern team site that isn't connected to a Microsoft 365 group (STS#3) and where the publishing feature has never been activated.
  • When you replace the root site, both the current site and the new site can't be hub sites or associated with a hub. If either site is a hub site, unregister it as a hub site, replace the root site, and then re-register the site as a hub site. If either site is associated with a hub, disassociate the site, replace the root site, and then reassociate the site. Learn how to manage hubs in the new SharePoint admin center
  • Replacing the root site with another site replaces the entire site collection with the new site collection. If your current root site has subsites, they'll be archived.
  • The site you select as the new root site must be within the same domain as the current root site.
  • If the site is on hold, you'll receive an informative error and you can't replace the site.

Use the new SharePoint admin center

We recommend replacing the root site at a time when site usage is low.

  1. Go to Active sites in the 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.

  1. In the upper right, make sure the All sites view is selected.

  2. In the URL column, select to sort A to Z so the current root site appears at the top of the list.

  3. Select the root site (https://contoso.sharepoint.com).

  4. Select Replace site on the command bar.

    The Replace root site panel in the new SharePoint admin center

  5. In the URL of the site you want to use box, enter the full or relative URL of the site that you want to become the new root site.

  6. Select Save.

    While the root site is being replaced, it might return a "not found" (HTTP 404) error for few minutes.

    After you replace the root site, content must be recrawled to update the search index. This might take some time depending on factors such as the amount of content in these sites. Anything dependent on the search index might return incomplete results until the sites have been recrawled.

  7. If the new root site was an organization news site, update the URL. Get a list of all organizational news sites

  8. If you disabled site redirects, you'll need to update sharing links and any apps or files (like the OneDrive sync app and OneNote files) to refer to the new URL.

Note

For info about using PowerShell to replace (swap) the root site, see Invoke-SPOSiteSwap.
Project Server sites might need to be validated to make sure they're still associated correctly.