Skip to content

spo site rename

Renames the URL and title of a site collection


spo site rename [options]


Option Description
--help output usage information
-u, --siteUrl <siteUrl> The URL of the site to rename
--newSiteUrl <newSiteUrl> New URL for the site collection
--newSiteTitle [newSiteTitle] New title for the site
--suppressMarketplaceAppCheck Suppress marketplace app check
--suppressWorkflow2013Check Suppress 2013 workflow check
--wait Wait for the job to complete
--query [query] JMESPath query string. See for more information and examples
-o, --output [output] Output type. json,text. Default text
--pretty Prettifies json output
--verbose Runs command with verbose logging
--debug Runs command with debug logging


To use this command you must have permissions to access the tenant admin site.


Renaming site collections is by default asynchronous and depending on the current state of Office 365, might take up to few minutes. If you're building a script with steps that require the operation to complete fully, you should use the --wait flag. When using this flag, the spo site rename command will keep running until it receives confirmation from Office 365 that the site rename operation has completed.


Starts the rename of the site collection with name "samplesite" to "renamed" without modifying the title

spo site rename --siteUrl --newSiteUrl

Starts the rename of the site collection with name "samplesite" to "renamed" modifying the title of the site to "New Title"

spo site rename --siteUrl --newSiteUrl --newSiteTitle "New Title"

Renames the specified site collection and waits for the operation to complete

spo site rename --siteUrl --newSiteUrl --newSiteTitle "New Title" --wait