# Navigation

The menu on the left is the way your users reach every screen. This lesson shows you how to add an item to it, choose
which roles see it, and hide one you don't need.

## Open the Navigation Editor

Open **Configuration → Application → Navigation**. The menu appears as a tree.

![The navigation tree editor](https://docs.kanoa.ai/img/navigation/navTreeEditor.png)

## Add a Menu Item

1. Select the item to add under, or select nothing to add at the top level.
2. Click the add button.
3. Enter a **Name**. It's what shows in the menu.
4. Set **Type** to a URL, and enter the web address.
5. Choose an **Icon** if you want one, and set the **Sort Order**.
6. Click save before you make any other change.

For example, add a link named `Kanoa Web Site` that opens `https://kanoa.ai`.

:::note
**Type** can also link to a view or page built in the Designer. Building that page is Developer Training. If your
developer has built one, you can link it here.
:::

{/*
TODO: confirm on a gateway the exact add-item button. The Developer Training lesson uses "Add Navigation Item" and
"Save Menu Item". At the root level: the docs now say to add the item, then clear its parent with the x next to Path.
Confirm where the web address goes: the docs name a Path field, but say it is informational.
*/}

## Choose Who Sees an Item

- **Roles**: add roles to show the item only to users with at least one of them. With none, everyone sees it.
- **Project**: pick the projects the item appears in. Leave it blank for all projects.
- **Enabled**: untick it to hide the item without deleting it.

Gateway Admins always see every item.

:::warning
The menu is shared. Hiding or deleting an item removes it for every user in the project. Rearrange items by dragging them
in the tree. To remove one for good, select it and use the delete button.
:::

::embed-section{src="../../configuration/navigation.md" collapsed="true" summary="Reference Materials: Navigation - The fields of a navigation item."}

## Check Your Understanding

1. How do you show a menu item only to supervisors?
2. How do you hide an item without deleting it?
3. A new link doesn't appear after you add it. What did you probably forget?

<details>
<summary>Answers</summary>

1. Add the **Supervisor** role in **Roles**.
2. Untick **Enabled**.
3. Saving it. The item must be saved before you make other edits.

</details>
