Tenant Migration

How to Rename a Microsoft 365 SharePoint Tenant URL

Amos Gikunda Sep 29, 2026 868 views

Question details

The administrator needs to change the SharePoint tenant domain name (the onmicrosoft.com domain) for their Microsoft 365 environment.

How to Rename a Microsoft 365 SharePoint Tenant URL

Product: Microsoft 365 / SharePoint Online
Device & OS: not provided
Scenario: A Microsoft 365 administrator wants to update the organization's SharePoint and OneDrive URLs to reflect a rebranding or corporate restructuring.
Observed behavior: The administrator must schedule a tenant domain rename using PowerShell while navigating the strict eligibility requirements and potential service impacts.

Before you start

Verify your organization's eligibility for a SharePoint tenant rename in the Microsoft 365 admin center, and carefully review Microsoft's official documentation to assess the impact on existing SharePoint links, OneDrive synchronization, Teams, Planner, and Power Automate workflows.

Solution 1Recommended

Schedule a SharePoint Tenant Rename via PowerShell

Use the SharePoint Online Management Shell to safely schedule the domain change for your SharePoint tenant.

Renaming a SharePoint tenant is an advanced operation that modifies your core Microsoft 365 environment. This cannot be executed instantly; the operation must be scheduled in advance, allowing Microsoft's backend systems to prepare for the domain transition.

Before running the commands, ensure you have added the new '.onmicrosoft.com' domain to your Microsoft 365 tenant and confirmed its health status.

Add the new onmicrosoft.com domain

Log in to the Microsoft 365 admin center, navigate to Settings > Domains, select 'Add domain', and configure your desired new '.onmicrosoft.com' domain. Wait until its status shows as Healthy.

Install the SharePoint Online Management Shell

On a Windows PC, download and install the latest version of the SharePoint Online Management Shell from the official Microsoft Download Center.

Connect to the SharePoint admin center

Open PowerShell as an Administrator and execute the command: Connect-SPOService -Url "https://yourtenant-admin.sharepoint.com" (replace 'yourtenant' with your current tenant name). Log in using your Global Administrator credentials.

Schedule the tenant rename operation

Execute the following command to schedule the rename at least 24 hours in the future: Start-SPOTenantRename -DomainName <new-domain> -ScheduledDateTime <YYYY-MM-DDTHH:MM:SS>. Replace <new-domain> with your newly added domain prefix and specify the desired date and time.

Schedule a SharePoint Tenant Rename via PowerShell

Scheduling Limitation: The tenant rename operation must be scheduled at least 24 hours in advance. Do not attempt to schedule it for a closer timeframe, or the PowerShell command will fail.

Free Microsoft Office alternative

Simplify Your Document Management with WPS Office

While Microsoft 365 manages complex enterprise backend systems like SharePoint tenant URLs, your team's everyday document creation doesn't need to be complicated. WPS Office provides a free, highly compatible, and user-friendly alternative for writing, calculating, and presenting.

1. Download the Installer: Visit the official WPS Office website and click the Free Download button for your operating system.
2. Install the Software: Run the downloaded installation file and follow the simple on-screen instructions to set up the office suite.
3. Start Creating: Open WPS Office and immediately start creating or editing Word, Excel, and PowerPoint documents with zero learning curve.

Completely free to use with an intuitive, familiar tabbed interfaceFully compatible with Microsoft Office formats including DOCX, XLSX, and PPTXLightweight application that runs smoothly without draining system resourcesBuilt-in robust PDF editing, conversion, and splitting toolsCross-platform support for Windows, macOS, Linux, Android, and iOS devices

Frequently Asked Questions

Will renaming my SharePoint tenant break existing shared links?

Changing the tenant domain can affect existing SharePoint and OneDrive links. While Microsoft automatically implements temporary redirects for most links, some third-party integrations, specific applications, and sync clients may require manual updates or reconnections.

Can I change my SharePoint domain to a custom domain like mycompany.com?

No. SharePoint and OneDrive URLs must always use the '.sharepoint.com' suffix. The rename process only allows you to change the prefix of the URL by adding a new '.onmicrosoft.com' domain to your Microsoft 365 environment.

How long does a SharePoint tenant rename take to complete?

Once the scheduled time is reached, the actual rename process can take anywhere from a few hours to a few days depending on the size of your tenant, the number of sites, and the amount of data stored in SharePoint and OneDrive.

Can I cancel a scheduled SharePoint tenant rename?

Yes, you can cancel the scheduled operation using the Stop-SPOTenantRename PowerShell cmdlet, provided you execute the cancellation command before the scheduled date and time is reached.

Migration & Recovery