# 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](/how-it-works/application-users-and-roles.md)

***

{% 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

![](/files/00m9ueU0ZpwbujzLZtt3)

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

![](/files/fASTzatgUUFco4NPSQwi)

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

![](/files/q2lsxrZZs5QwZyXXLHDx)

***

### Render Options

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

![](/files/7qUllirHJL4NC6eixO8T)

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

![](/files/uQqtOsD0uQdl2kcFg8fg)

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.

  ![](/files/KAV7EkOll3k5gbvGBDbe)

***

### 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.

![](/files/PhC5oYoMfdrUsHXLBa8q)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.stadium.software/controls/menu.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.