# Menu Navigation The sidebar layout helps you stay organized by providing a clear and structured view of all your apps, reducing clutter and confusion. By grouping your apps together in the sidebar, navigation simplifies the process of finding and selecting the app you need to use.

## Menu items In the **Navigation** editor, click **+ New** to add menu items.

Select a menu item, choose the app to navigate to, and change the label and icon if needed. The app is displayed on the canvas in real time. ### Add submenu items To add submenu items, click `···` > **Add submenu item**, or drag `⋮⋮` to make one menu item subordinated to another.

{% hint style="warning" %} A parent menu item can only expand or fold the submenu items. You cannot link an app to it. When you delete a parent menu item, all submenu items under it are deleted at the same time. {% endhint %} ### Properties #### Menu - Manual

| Property | Description | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Action |

Go to an other app - this will take open the specified app for the menu item click.
Open a URL - this will open the mentioned URL upon the menu item click.

The visibility of items is explained in the sections below.

| | Label | The text to be displayed to represent the menu item. | | Icon | Choose one from the set of icons that will be displayed as a prefix logo. | | Hide | This sets whether this item has to be displayed on the screen when the program is loaded. This shows/hides the option both on desktop and mobile devices. | #### Menu - JSON Provide the content for the menu items as a JSON array.

```json [ { "label": "Menu Item 1", "key": "menu-item-1", "icon": "https://cdn-icons-png.flaticon.com/128/149/149338.png", "action": { "url": "https://docs.appizap.ae/", "newTab": false }, "children": [ { "label": "Submenu Item 1", "key": "submenu-item-11", "icon": "", "action": { "url": "https://docs.appizap.ae/", "newTab": false } }, { "label": "Submenu Item 2", "key": "submenu-item-12", "icon": "", "action": { "url": "https://docs.appizap.ae/", "newTab": false } } ] }, { "label": "Menu Item 2", "key": "menu-item-2", "icon": "https://cdn-icons-png.flaticon.com/128/149/149206.png", "action": { "url": "https://docs.appizap.ae/", "newTab": true } } ] ``` | Property | Description | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | Action |

#### Position `Inline` - keeps the menus and their submenus in collapsible and retrievable style.

`Vertical` - keeps the menus and their submenus as a parent-child tree structure.

### Menu Style

Property	Description
Background	Users can change the colour of the text background using this property. It has all the RGB colour ranges to pick from. It is recommended to use a corresponding background colour that shows the font clearly.
Border Color	Set the colour to the border lines. The border lines will be shown only if that is enabled.
Border Radius	This sets the radius of the widget's corners, enabling rounded corners on the widget. This value is defined in "px" terms.
Text	Set the colour of the options' text. Recommended to set in contrast with the background.
Margin	This value is set in terms of "px" number which creates the space between the border and the content of the widget.
Padding	This value is set in terms of "px" number which creates the space between the border and outer elements.

### Menu Item Style #### Normal

Property	Description
Background	Users can change the colour of the text background using this property. It has all the RGB colour ranges to pick from. It is recommended to use a corresponding background colour that shows the font clearly.
Border Color	Set the colour to the border lines. The border lines will be shown only if that is enabled.
Border Radius	This sets the radius of the widget's corners, enabling rounded corners on the widget. This value is defined in "px" terms.
Text	Set the colour of the options' text. Recommended to set in contrast with the background.
Margin	This value is set in terms of "px" number which creates the space between the border and the content of the widget.
Padding	This value is set in terms of "px" number which creates the space between the border and outer elements.

#### Hover

Property	Description
Background	Users can change the colour of the text background using this property. It has all the RGB colour ranges to pick from. It is recommended to use a corresponding background colour that shows the font clearly.
Border Color	Set the colour to the border lines. The border lines will be shown only if that is enabled.
Text	Set the colour of the options' text. Recommended to set in contrast with the background.

#### Active

Property	Description
Background	Users can change the colour of the text background using this property. It has all the RGB colour ranges to pick from. It is recommended to use a corresponding background colour that shows the font clearly.
Border Color	Set the colour to the border lines. The border lines will be shown only if that is enabled.
Text	Set the colour of the options' text. Recommended to set in contrast with the background.

### Add URL parameters Add URL query parameters or hash parameters to a menu item with `key` and `value`.

Then click the menu item on the canvas, and the parameters are appended to the URL of the app to be opened. You can check in **Globals** tab in the left pane.

{% hint style="info" %} To reference the url parameters, use `{{url.query.key1}}` or `{{url.hash.key1}}` in your app. {% endhint %} ### Visibility of menu items By default, a menu item is hidden for users without app permission. When you toggle this option off, the users can see the menu item but cannot view the app it references to.

## Permissions The authorization levels required for accessing navigational features are identical to those needed for interacting with modules and applications.