page-section-add.mdx

import Global from '/docs/cmd/_global.mdx';

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.

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.