Skip to main content

spo page control list

Lists controls on the specific modern page


m365 spo page control list [options]


-n, --pageName <pageName>

Name of the page to list controls of.

-u, --webUrl <webUrl>

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

-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 for more information and examples.

-o, --output [output]

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


Runs command with verbose logging.


Runs command with debug logging.


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


List controls on the modern page

m365 spo page control list --webUrl --pageName home.aspx


"id": "7558d804-0334-49ca-b14a-53870cf6caae",
"type": "Client-side web part",
"title": "Bing Maps",
"controlType": 3,
"order": 1,
"controlData": {
"controlType": 3,
"displayMode": 2,
"id": "7558d804-0334-49ca-b14a-53870cf6caae",
"position": {
"controlIndex": 1,
"sectionIndex": 1,
"zoneIndex": 1,
"sectionFactor": 12,
"layoutIndex": 1
"webPartId": "e377ea37-9047-43b9-8cdb-a761be2f8e09",
"emphasis": {},
"webPartData": {
"dataVersion": "1.0",
"description": "Display a location on a map using Bing Maps.",
"id": "e377ea37-9047-43b9-8cdb-a761be2f8e09",
"instanceId": "7558d804-0334-49ca-b14a-53870cf6caae",
"properties": {
"pushPins": [],
"maxNumberOfPushPins": 1,
"shouldShowPushPinTitle": true,
"zoomLevel": 12,
"mapType": "road"
"title": "Bing Maps",
"serverProcessedContent": {
"htmlStrings": {},
"searchablePlainTexts": {},
"imageSources": {},
"links": {}