Skip to main content

spo web set

Updates subsite properties

Usage​

m365 spo web set [options]

Options​

-u, --url <url>

URL of the subsite to update

-t, --title [title]

New title for the subsite

-d, --description [description]

New description for the subsite

--siteLogoUrl [siteLogoUrl]

New site logo URL for the subsite. Set to empty string to reset to default.

--quickLaunchEnabled [quickLaunchEnabled]

Set to true to enable quick launch and to false to disable it

--headerLayout [headerLayout]

Configures the site header. Allowed values standard,compact

--headerEmphasis [headerEmphasis]

Configures the site header background. Allowed values 0, 1, 2, 3

--megaMenuEnabled [megaMenuEnabled]

Set to true to change the menu style to megamenu. Set to false to use the cascading menu style

--footerEnabled [footerEnabled]

Set to true to enable footer and to false to disable it

--navAudienceTargetingEnabled [navAudienceTargetingEnabled]

Enable or disable site navigation audience targeting. Allowed values: true or false.

--searchScope [searchScope]

Search scope to set in the site. Allowed values DefaultScope, Tenant, Hub, Site.

--welcomePage [welcomePage]

Site-relative URL of the welcome page for the 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, permissions, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

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

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

Next to updating web properties corresponding to the options of this command, you can update the value of any other web property using its CSOM name, eg. --AllowAutomaticASPXPageIndexing. At this moment, the CLI supports properties of types Boolean, String and Int32.

Examples​

Update subsite title

m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --title Team-a

Hide quick launch on the subsite

m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --quickLaunchEnabled false

Set site header layout to compact

m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --headerLayout compact

Set site header color to primary theme background color

m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --headerEmphasis 0

Enable megamenu in the site

m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --megaMenuEnabled true

Hide footer in the site

m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --footerEnabled false

Enable navigation audience targetting in the site

m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --navAudienceTargetingEnabled true

Set search scope to tenant scope

m365 spo web set --url https://contoso.sharepoint.com/sites/team-a --searchScope tenant

Set welcome page for the web

m365 spo web set  --url https://contoso.sharepoint.com/sites/team-a --welcomePage "SitePages/new-home.aspx"

Response​

The command won't return a response on success.

More information​