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 isoptions
.--query [query]
JMESPath query string. See http://jmespath.org/ for more information and examples.
-o, --output [output]
Output type.
json
,text
,csv
,md
,none
. Defaultjson
.--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.