Skip to main content

spo web add

Create new subsite


m365 spo web add [options]


-t, --title <title>

Subsite title

-d, --description [description]

Subsite description

-u, --url <url>

Subsite relative url

-w, --webTemplate <webTemplate>

Subsite template, eg. STS#0 (Classic team site)

-p, --parentWebUrl <parentWebUrl>

URL of the parent site under which to create the subsite

-l, --locale [locale]

Subsite locale LCID, eg. 1033 for en-US. Default 1033


Set to not inherit permissions from the parent site


Set to inherit the navigation from the parent site

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.


Runs command with verbose logging.


Runs command with debug logging.


Create subsite using the Team site template in the en-US locale

m365 spo web add --title Subsite --description Subsite --url subsite --webTemplate STS#0 --parentWebUrl --locale 1033

Create subsite with unique permissions using the default en-US locale

m365 spo web add --title Subsite --url subsite --webTemplate STS#0 --parentWebUrl --breakInheritance

Create subsite with the same navigation as the parent site

m365 spo web add --title Subsite --url subsite --webTemplate STS#0 --parentWebUrl --inheritNavigation


"Configuration": 0,
"Created": "2022-11-05T14:07:51",
"Description": "Subsite",
"Id": "b60137df-c3dc-4984-9def-8edcf7c98ab9",
"Language": 1033,
"LastItemModifiedDate": "2022-11-05T14:08:03Z",
"LastItemUserModifiedDate": "2022-11-05T14:08:03Z",
"ServerRelativeUrl": "/subsite",
"Title": "Subsite",
"WebTemplate": "STS",
"WebTemplateId": 0