Skip to content

spo sitedesign add

Adds site design for creating modern sites


m365 spo sitedesign add [options]


-t, --title <title>
The display name of the site design
-w, --webTemplate <webTemplate>
Identifies which base template to add the design to. Allowed values TeamSite,CommunicationSite
-s, --siteScripts <siteScripts>
Comma-separated list of site script IDs. The scripts will run in the order listed
-d, --description [description]
The display description of site design
-m, --previewImageUrl [previewImageUrl]
The URL of a preview image. If none is specified SharePoint will use a generic image
-a, --previewImageAltText [previewImageAltText]
The alt text description of the image for accessibility
Set if the site design is applied as the default site design
-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 full.
--query [query]
JMESPath query string. See for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
Runs command with verbose logging
Runs command with debug logging


Each time you execute the spo sitedesign add command, it will create a new site design with a unique ID. Before creating a site design, be sure that another design with the same name doesn't already exist.

When specifying IDs of site scripts to use with your site design, ensure that the IDs refer to existing site scripts or provisioning sites using the design will lead to unexpected results.


Create new site design for provisioning modern team sites

m365 spo sitedesign add --title "Contoso team site" --webTemplate TeamSite --siteScripts "19b0e1b2-e3d1-473f-9394-f08c198ef43e,b2307a39-e878-458b-bc90-03bc578531d6"

Create new default site design for provisioning modern communication sites

m365 spo sitedesign add --title "Contoso communication site" --webTemplate CommunicationSite --siteScripts "19b0e1b2-e3d1-473f-9394-f08c198ef43e" --isDefault

More information