Skip to content

spo navigation node add

Adds a navigation node to the specified site navigation

Usage

spo navigation node add [options]

Options

Option Description
--help output usage information
-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
--isExternal Set, if the navigation node points to an external URL
-o, --output [output] Output type. json|text. Default text
--verbose Runs command with verbose logging
--debug Runs command with debug logging

Important

Before using this command, log in to a SharePoint Online site, using the spo login command.

Remarks

To add a navigation node to a site, you have to first log in to a SharePoint Online site using the spo login command, eg. spo login https://contoso.sharepoint.com.

Examples

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

spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location TopNavigationBar --title About --url /sites/team-s/sitepages/about.aspx

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

spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --location QuickLaunch --title "About us" --url https://contoso.com/about-us --isExternal

Add a navigation node below an existing node

spo navigation node add --webUrl https://contoso.sharepoint.com/sites/team-a --parentNodeId 2010 --title About --url /sites/team-s/sitepages/about.aspx