Skip to main content

spo page section add

Adds section to modern page

Usage​

m365 spo page section add [options]

Options​

-n, --pageName <pageName>

Name of the page to add section to.

-u, --webUrl <webUrl>

URL of the site where the page to retrieve is located.

-t, --sectionTemplate <sectionTemplate>

Type of section to add. Allowed values OneColumn, OneColumnFullWidth, TwoColumn, ThreeColumn, TwoColumnLeft, TwoColumnRight, Vertical.

--order [order]

Order of the section to add.

--zoneEmphasis [zoneEmphasis]

Section background shading. Allowed values None, Neutral, Soft, Strong

--isLayoutReflowOnTop

The position of the Vertical section for smaller screens. Applied only for Vertical section.

-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 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​

If the specified pageName doesn't refer to an existing modern page, you will get a File doesn't exists error.

Examples​

Add section to the modern page

m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --order 1

Add section with background shading to the modern page

m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --zoneEmphasis Strong

Add a vertical section to the modern page. There can only be one vertical section per page. If a vertical section already exists on the page, the command will not have any effect.

m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate Vertical

Add Vertical section with background shading to the modern page with adjusting the position of this section for smaller screens to the top

m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate Vertical --zoneEmphasis Neutral --isLayoutReflowOnTop

Response​

The command won't return a response on success.

CTRL + M