# Menu

Use a Menu control to enable users to navigate in applications. Menus are multi-level and can contain an unlimited number of top-level and sub-items. Stadium provides two options for rendering menus, left-to-right and top-to-bottom.

### Menu Item Access

Applications automatically hide menu items that link to pages logged-in users cannot access. Menu items to access-restricted pages are only visible to users assigned to roles that also have access the underlying pages. See [Application Users and Roles](https://docs.stadium.software/how-it-works/application-users-and-roles)

***

{% embed url="<https://www.youtube.com/embed/DdyGPIenLJ0?autoplay=1&rel=0&vq=1080>" %}
*Add a Menu*
{% endembed %}

***

### Properties

1. **Direction**

   You can create a left-to-right or a top-to-bottom layout for this menu.
2. **Items**

   A collection of all the items in your menu. Add new items, edit existing items and change the order and grouping in the *Menu Item Editor*. You can create unlimited levels of items with this menu.
3. **Visible**

   Set to False if you don't want this control to render on the page and be visible to the user.

***

### Menu Management

In order to see the properties on the Menu click outside the menu items as shown below

![](https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-81d7b337369ecb8aa3fcc3ecd731e3ca5792da80%2Fmenu-selected.png?alt=media)

To see the properties of the individual menu items click on the item. Left click on a Parent Item to see its children.

![](https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-c8797d7d7cc757a31053480ed29ba51bf5915cea%2Fmenu-items-view.png?alt=media)

Right click on an item to add other items and edit the layout

![](https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-479595a6bf7cfe5914f3fe6f9a0af05a012c7e43%2Fmenu-item-rightclick.png?alt=media)

***

### Render Options

The sub-items for the left-to-right menu are shown below that menu.

![](https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-f6412ba6910c4067b77b7b1f75a9d7b1bce2477e%2Fmenuhorizontal.png?alt=media)

The sub-items for the top-to-bottom menu are shown to the right of that menu.

![](https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-50144136c2c4a63d914ee328897cd502a9a1e9d0%2Fmenuvertical.png?alt=media)

Individual menu items also have two properties that you can see when you click on a specific menu item, rather than the menu box around the items.

* Destination Page\
  You can enter an absolute or a relative link in the textbox or select a dynamic value from the drop-down.
* Text\
  The text shown on this menu item.

  ![](https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-4c1acf228730d49a643e972372ada45a40db90c4%2Fmenu-link.png?alt=media)

***

### Menu Item Editor

Stadium contains a tool, called the *Menu Item Editor*, to assist with the management of menu items. In this tool you can define all items for a menu as well as the text and link for each one. You can add a separator between two items in a sub-menu to visually separate them.

![](https://3514041584-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FqxH8JA8xG3I22tiZG5H6%2Fuploads%2Fgit-blob-f443e3915a530f6e3c3ad84c2904c3715338471b%2Fmenu-item-editor.png?alt=media)