Configure navigation menus

1 Permissions
2 Create a navigation menu
- 2.1 Menu types
3 Add items to a menu
- 3.1 Build a nested structure
4 Edit an item
- 4.1 Item settings
5 Delete items
6 Manage an existing menu
7 Options and settings

Navigation menus are where you build your navigation. You create a menu, choose where it appears, then add the folders and links your users need.

Nothing is preconfigured when you install the app. You start with an empty list.

Permissions

You need Confluence administrator permissions to create and edit navigation menus.

Create a navigation menu

Go to Confluence administration → Settings → STAGIL Navigation → Navigation menus.
Select Add navigation menu.
Enter a Name. This is how the menu appears in your list, not to your users.
Select a Type. Once you've created a Site panel or Browser extension menu, that type is no longer available, because you can have only one of each.
For a Space panel menu, choose where it applies using Space categories, Space(s), or both.
Select Add. The menu appears in your list.

Space panel menus ask where they apply

Each menu shows its type and where it applies

Menu types

Type	Where the menu appears	How many you can create

Type	Where the menu appears	How many you can create
Site panel	Across your whole site	One
Browser extension	The Confluence sidebar, for users with the STAGIL browser extension	One
Space panel	The spaces you choose, by category or by name	More than one

Site panel and Browser extension menus apply everywhere, so the Space categories and Spaces columns in your list show Global context by default for them.

Add items to a menu

Select the more actions (•••) icon next to your menu, then select Configure.
Select a Type for the item: Internal link, Web link, Sub Navigation, or CQL.
Select an Icon, if you want one.
Enter a Display name.
Complete the remaining field for the type you chose. Internal links use Link to select your Confluence content.
Select +. The item appears in the tree below.

Choose what kind of item you're adding

For details on each type, see Navigation item types.

Build a nested structure

Use Sub Navigation items to group links into folders.

To add an item inside a folder, hover over the folder and select +. The new item is nested inside it.

Sub Navigation items hold other items, so you can group related links

To go back to your list of menus, select the back arrow next to the menu name.

Edit an item

Hover over the item, then select the more actions (•••) icon.
Select Edit.
Change the details you need.
Select Save.

You can change an item's type here. A menu's type is fixed once you create it, but an item's isn't.

Item actions appear when you hover over a row

The edit dialog is also where you set who can see the item.

Item settings

Setting	What it does

Setting	What it does
Icon	Icon adds an image next to the item. Choose one of the built-in icons, or upload your own from your device (PNG, JPG/JPEG, SVG, or ICO, up to 48×48px).
Show only icon	Hides the display name and leaves just the icon.
Display name	The label your users see
Show only icon	Hides the display name, leaving just the icon
Type	What kind of item this is
Allow list	The permission groups that can see this item
Block list	The permission groups that can't see this item

Every item has an Allow list and a Block list, whatever its type. For how they work together, see Visibility and permissions.

Delete items

To delete one item, hover over it, select the more actions (•••) icon, then select Delete.

To delete several items at once:

Select the checkbox next to each item you want to remove. Selecting a folder also selects everything inside it. To select the whole menu, select Select all.
Select Delete.

The bar above the tree shows how many items you've selected.

You can delete several items at once, but you can only edit them one at a time.

Manage an existing menu

Select the more actions (•••) icon next to a menu:

Option	What it does

Option	What it does
Edit	Reopens the menu's settings, where you can change the name and the restricted content option
Configure	Opens the menu so you can add and arrange items
Delete	Removes the menu

You can't change a menu's type after you create it. The Type field is read-only when you edit a menu. To use a different type, create a new menu.

Options and settings

Enable always-visible navigation sits at the top of the Navigation menus page and applies to your whole site. It's on by default, which shows your Site panel and Space panel menus as a permanent navigation bar. Turn it off and users get a button instead, which opens your navigation over the Confluence header when they select it. This suits people who'd rather not give up the screen space. See Advanced Navigation.

Hide restricted content from navigation is set for each menu, in the Add or Edit dialog. It's off by default, so users see every item in the menu, including links to content they can't open. Turn it on to hide those items instead. As the tooltip notes, hiding content based on restrictions may slow down the performance, because the app checks each user's access to every item.