Change your organization's SharePoint URL (tenant rename)

Your organization has a new name, but your SharePoint and OneDrive addresses still show the old one, such as oldname.sharepoint.com. Can you change that? Yes: with a SharePoint domain rename (tenant rename) you change the address. It's a big change though, affecting every site and every OneDrive. This article explains exactly what changes, how to schedule the rename with PowerShell and how to prepare your organization.

What changes?

• The address of all SharePoint sites and OneDrives, for example from oldname.sharepoint.com to newname.sharepoint.com and from oldname-my.sharepoint.com to newname-my.sharepoint.com.
• The address of the SharePoint admin center, which follows the new name. Keep an overview of the right addresses in all Microsoft 365 admin portals in one list.
• Your email addresses and the name of your Microsoft 365 organization do not change. You manage those separately through your domains.
• Your original .onmicrosoft.com domain stays. You can never remove it, not even after the rename.

The content itself stays where it is: files, permissions, version history and metadata don't change. Only the address you use to reach them changes.

Prepare

Start well in advance, especially in a large environment. Good preparation consists of:

1. Inventory: find out where the old address is hard-coded. Think of Power Automate flows, Power Apps, SharePoint add-ins, scripts, integrations with third-party apps and links in documentation or intranet pages.
2. Testing: if you have a test environment, try the rename there first.
3. Communication: let users know when it happens, what they may notice and where they can go with questions. Also check alerts and notifications users have set up, because they may point to the old address.
4. Timing: schedule the rename outside working hours and not just before a busy period.

The steps

1. In the Microsoft 365 admin center, add a new .onmicrosoft.com domain with the name you want (Settings > Domains). If another organization already uses the name, you have to choose a different one.
2. Install the latest version of the SharePoint Online Management Shell and connect as a SharePoint admin. New to this? Read PowerShell for Microsoft 365.
3. Schedule the rename, at least a few days ahead:

   Start-SPOTenantRename -DomainName "newname" -ScheduledDateTime "2026-11-15T22:00:00"

   Microsoft requires a minimum lead time and a maximum window for the scheduled moment; check the current requirements in the documentation.
4. Follow the status with Get-SPOTenantRenameStatus. As long as the rename hasn't started, you can cancel it.

What to watch out for

• Old links keep working for a while through redirects, but not always in apps and scripts.
• OneDrive sync, shortcuts, Power Automate flows, Power Apps and third-party apps may need to be set up again.
• Large environments take longer and limits apply, for example on the number of sites. Some configurations, such as multi-geo environments, have extra requirements. Check Microsoft's requirements first.
• During the rename, sites may temporarily be read-only or respond more slowly.
• Search results and recent files in the Office apps may need some time to show the new addresses. Copilot and agents in SharePoint also work with the new addresses once the index has been updated.
• Tell users in advance and schedule the change outside working hours.

After the rename

1. Check a few important sites, OneDrives and Teams files.
2. Update flows, apps and scripts that use the old address.
3. Update links in intranet pages, manuals and email signatures.
4. Ask users to report problems with syncing or saved links.

Frequently asked questions

• Does my email address change? No. If you want to change that too, add a domain to Microsoft 365 and change user addresses separately, for example by changing the UserPrincipalName.
• Do guests need to be invited again? No, their access remains. They do use the new address. Cleaning up old guest accounts at the same time? Read completely remove a guest or old account from SharePoint Online.
• Can I undo the rename? Not just like that. So choose the new name carefully and take possible future name changes into account.

Nederlandstalige versie: De SharePoint-URL van je organisatie wijzigen (tenant rename)

Related articles