Skip to content

spo navigation node add

Adds a navigation node to the specified site navigation


m365 spo navigation node add [options]


-u, --webUrl <webUrl>
Absolute URL of the site to which navigation should be modified
-l, --location [location]
Navigation type where the node should be added. Available options: QuickLaunch, TopNavigationBar
-t, --title <title>
Navigation node title
--url <url>
Navigation node URL
--parentNodeId [parentNodeId]
ID of the node below which the node should be added
Set, if the navigation node points to an external URL
-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 full.
--query [query]
JMESPath query string. See for more information and examples
-o, --output [output]
Output type. json,text,csv. Default json
Runs command with verbose logging
Runs command with debug logging


Add a navigation node pointing to a SharePoint page to the top navigation

m365 spo navigation node add --webUrl --location TopNavigationBar --title About --url /sites/team-s/sitepages/about.aspx

Add a navigation node pointing to an external page to the quick launch

m365 spo navigation node add --webUrl --location QuickLaunch --title "About us" --url --isExternal

Add a navigation node below an existing node

m365 spo navigation node add --webUrl --parentNodeId 2010 --title About --url /sites/team-s/sitepages/about.aspx


  "AudienceIds": null,
  "CurrentLCID": 1033,
  "Id": 2030,
  "IsDocLib": true,
  "IsExternal": true,
  "IsVisible": true,
  "ListTemplateType": 0,
  "Title": "Navigation Link",
  "Url": ""
AudienceIds     : null
CurrentLCID     : 1033
Id              : 2031
IsDocLib        : true
IsExternal      : true
IsVisible       : true
ListTemplateType: 0
Title           : Navigation Link
Url             :
,1033,2032,1,1,1,0,Navigation Link,