When an organization rebrands, merges, or acquires another company, the SharePoint domain name (contoso.sharepoint.com) may need to change. Per Microsoft Learn, you can rename your SharePoint domain using the Start-SPOTenantRename PowerShell cmdlet.
This changes all SharePoint and OneDrive URLs from the old domain to the new one. For example, contoso.sharepoint.com becomes fabrikam.sharepoint.com. Per Microsoft, the rename is a one-time operation (additional renames require a support request), and sites become temporarily inaccessible during the process.
This tutorial covers the standard rename for tenants with up to 10,000 sites. For larger tenants, SharePoint Advanced Management provides Advanced Tenant Rename with priority site execution.
Before you start
What you will learn
- You'll learn how to change your SharePoint and OneDrive domain name in Microsoft 365 using PowerShell, including prerequisites, scheduling, and post-rename verification.
- After a rebrand or merger, the old SharePoint domain creates confusion and doesn't reflect the new organization name. Per Microsoft Learn, the tenant rename updates all SharePoint and OneDrive URLs to the new domain.
Requirements
- Microsoft 365 admin center and SharePoint Online Management Shell.
- Tenant with fewer than 10,000 sites (standard rename) or SharePoint Advanced Management license (advanced rename for larger tenants).
- SharePoint Administrator or Global Administrator
Good to know
- 30 minutes to configure, hours to days for execution
Quick answer
Add your new .onmicrosoft.com domain in the M365 Admin Center, then use Start-SPOTenantRename in SharePoint Online Management Shell to schedule the rename. The process takes hours to days. Sites are temporarily inaccessible. This is a one-time operation.
M365 Admin Center > Domains > Add .onmicrosoft.com domain, then PowerShellStart-SPOTenantRename -DomainName "fabrikam" -ScheduledDateTime "2026-08-01T02:00:00"Step-by-step tutorial
5 stepsAdd the New .onmicrosoft.com Domain
Register the new domain name that SharePoint will use.
admin.microsoft.com > Settings > DomainsSign in to the Microsoft 365 admin center (admin.microsoft.com). Go to Settings > Domains. Add your new .onmicrosoft.com domain using the Domains page.
Per Microsoft Learn, do NOT use the 'Add domain' option directly, as it doesn't create a .onmicrosoft.com domain. Do NOT make this domain your fallback domain. Wait for the domain to show 'Healthy' status.
The new domain must be a .onmicrosoft.com domain. It must not already be in use by another tenant. Per Microsoft, if the domain is taken, contact the other organization or delete the tenant that holds it.
Install and Connect to SharePoint Online Management Shell
Connect to your SharePoint tenant via PowerShell.
Open PowerShell as administrator. Install the latest SharePoint Online Management Shell if needed:
Install-Module -Name Microsoft.Online.SharePoint.PowerShell -ForceConnect to your SharePoint admin site:
Connect-SPOService -Url https://contoso-admin.sharepoint.comReplace contoso with your current tenant name. Authenticate with your SharePoint Administrator credentials.
Install-Module -Name Microsoft.Online.SharePoint.PowerShell -Force
Connect-SPOService -Url https://contoso-admin.sharepoint.comYou must have the latest version of the SharePoint Online Management Shell. Older versions may not have the Start-SPOTenantRename cmdlet.
Schedule the Tenant Rename
Schedule the SharePoint domain rename.
Run the rename command with your new domain name and a scheduled date/time:
Start-SPOTenantRename -DomainName "fabrikam" -ScheduledDateTime "2026-08-02T02:00:00"Replace fabrikam with your new domain name (without .sharepoint.com). Per Microsoft, the scheduled time must be at least 24 hours in the future and within 30 days.
Start-SPOTenantRename -DomainName "fabrikam" -ScheduledDateTime "2026-08-02T02:00:00"Per Microsoft, schedule during a period of low usage (weekends recommended). Sites become temporarily inaccessible during the rename. New OneDrive and site creation is blocked during the process.
Monitor and Verify the Rename
Monitor and verify the rename progress.
Check the rename status periodically:
Get-SPOTenantRenameStatusThe status progresses through: Scheduled, InProgress, and Completed. Per Microsoft, the process can take hours to days depending on the number of sites.
Get-SPOTenantRenameStatusIf status shows an error code, refer to Microsoft's error code reference. Common errors: 775 (scheduling), 777 (public sites), 780 (too many sites), 783 (already renamed once).
Update Integrations and References
Update all references to the old domain name.
After the rename completes, update all references to the old SharePoint domain:
- Firewall rules allowing the new domain
- Browser trusted sites and Group Policy settings
- Third-party applications that access SharePoint
- Custom apps and scripts referencing SharePoint URLs
- SharePoint Framework (SPFx) solutions and API access settings
- User bookmarks and documentation
- OneDrive sync client (should reconnect automatically)
Old URLs redirect to the new domain for a transition period, but don't rely on redirects long-term. Update all references proactively.
Verify the Domain Rename Completed Successfully
After the rename completes, verify that all SharePoint and OneDrive URLs use the new domain. Old URLs automatically redirect to the new domain for a transition period.
Per Microsoft Learn, check the rename status using Get-SPOTenantRenameStatus in PowerShell. The status should show 'Completed' once all sites are renamed.
Verify key sites by browsing to them directly. Check that OneDrive sync clients reconnect automatically (they should). Test third-party integrations and custom apps that reference SharePoint URLs.
- Get-SPOTenantRenameStatus shows Completed. All sites use the new domain. Old URLs redirect.
- Get-SPOTenantRenameStatus shows Failed or an error code. Check the error code reference in Microsoft's documentation.
- All sites now use the new domain.
- Old URLs redirect automatically.
Troubleshooting
Error 775: Invalid scheduling parameters
Cause: The scheduled date is less than 24 hours in the future or more than 30 days out.
Schedule the rename between 24 hours and 30 days from now.
Error 780: Too many sites
Cause: The tenant has more than 10,000 total SharePoint sites and OneDrive accounts.
Purchase SharePoint Advanced Management licenses and use Advanced Tenant Rename instead.
Error 783: Tenant already renamed
Cause: The tenant has already been renamed once. Per Microsoft, additional renames require a support request.
Open a Microsoft support request using the 'Rename a SharePoint Tenant more than once' path.
Frequently asked questions
Can I rename my SharePoint domain more than once?
Per Microsoft Learn, you can only rename once per tenant. Additional renames require a Microsoft support request.
Does this change my email domain?
No. The SharePoint domain rename only changes *.sharepoint.com URLs. Email addresses are configured separately in the M365 Admin Center.
How long does the rename take?
Hours to days depending on the number of sites and OneDrive accounts. Per Microsoft, schedule during low-usage periods.
Are there size or tenant type limitations?
Per Microsoft Learn, this feature is not available for GCC, GCC High, DoD, or Multi-Geo tenants. Standard rename supports up to 10,000 sites. Advanced Tenant Rename (requires SharePoint Advanced Management) supports unlimited sites.
