> ## Documentation Index
> Fetch the complete documentation index at: https://help.standards.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Navigation Menu

Navigation Menus are a persistent element that allows viewers to easily access different sections, pages, languages, or resources within a website.

<Frame>
  <img src="https://mintcdn.com/standards/hB74a56ScrOq-vgV/images/menu-example.png?fit=max&auto=format&n=hB74a56ScrOq-vgV&q=85&s=caf4a72604593a39170fdf38ce107652" alt="Example left sidebar menu with logo, menu groups, and jump links" width="1200" height="600" data-path="images/menu-example.png" />
</Frame>

***

## Basics

Menus are elements that can be added to your project, and exist outside the document grid and max width. Menus can hold most content, and can be linked up to pages, downloads, external URLs, and more.

* **Menus** are not constrained to mirror the pages of the project
* All **menus** follow the same base settings
* **Menus** can be styled different for each breakpoint
* **Menus** are well suited for Buttons and Dropdowns as navigation, but can contain almost any element
* Only one **menu** is allowed

### Elements inside menus

* **Controls:** Visible when a menu has an open & closed state, the controls are a button that control triggering the opening and closing of the menu.
* **Logo:** A special media layer with absolute positioning, the logo inside menus can be shown in either open and or closed states, and be filled with different files.

***

## Adding a menu

<Frame>
  <img src="https://mintcdn.com/standards/epOCltYvHgO46OhL/images/Adding-menus.gif?s=aeee78a1e829bfff730c260be01405f6" alt="Add menu flow" width="1080" height="540" data-path="images/Adding-menus.gif" />
</Frame>

<Steps>
  <Step title="Select menu tab">
    Within the editor, select the **Menu** tab from the left sidebar
  </Step>

  <Step title="Add new menu">
    Select the **New menu** button. If an existing menu exists, it must be deleted prior to adding a new one
  </Step>

  <Step title="Choose new menu type">
    Choose a menu type as a starting place for your new **menu.** Note: All menus shown are the same element, just with different setting applied.
  </Step>
</Steps>

<Info>
  **Keep in mind:** If your project already has a menu, you can delete it to add a new one. Be aware if you delete an existing menu you will need to restyle and link buttons in the new one.
</Info>

### Menu options

When adding a new **menu**, there are various styling options to start from. Keep in mind that all **menus** can be achieved by simply changing the settings of the **menu** at any point once it’s added. For instance, a flyout menu can be changed to a sidebar by editing the sizing and ‘always open’ settings.

***

## Native elements

Within every menu are two native elements:

1. **Logo**
2. **Controls**

Both of these elements have unique properties, most noticeably that they can be absolutely positioned. They can be shown or hidden using the layer visibility toggle (eye icon) in the left sidebar.

### Logo

This element is intended for the brand’s logo. Both the open and closed state of the menu can have this element, and they can differ from one another.

### Controls

This content element is used to control opening and closing the menu. Both the open and closed state can have this element, and they can differ from one another.

***

## Adding content to menus

Almost all elements in Standards may be added to a **menu**. Anything you can add to a **column** can be added to a **menu. Keep in mind:** The contents of menus is flexbile and can be configured to best fit your guideline and each breakpoint.

<Frame>
  <img src="https://mintcdn.com/standards/epOCltYvHgO46OhL/images/Adding-content-to-Menus.gif?s=6705cc5c4941c33e621853e57cc48b65" alt="A dropdown being added to an existing menu using" width="1080" height="540" data-path="images/Adding-content-to-Menus.gif" />
</Frame>

<Steps>
  <Step title="Choose add tool">
    From within the editor, select elements  like **media** <kbd>M</kbd>, **text** <kbd>T</kbd>, and **button** <kbd>B</kbd> from the + menu. Some **components** <kbd>C</kbd> may also be chosen to add into menus.
  </Step>

  <Step title="Select menu">
    Hover over the open **menu**, and select the add point overlay.
  </Step>

  <Step title="Reorder and style">
    Menu content can be reordered by click + dragging from the **menu** layers in the left sidebar. Each item can be styled by selecting them and modifying their settings in the right sidebar as normal.
  </Step>

  <Step title="Set links">
    Link buttons to pages, URL’s, and more by selecting them, choose click from the contextual toolbar, then adding a **click** behavior.
  </Step>
</Steps>

<Info>
  **Keep in mind:** **Layouts**, **groups**, and by extension **automations** or any **components** of **layouts** and **groups** cannot be added inside a **menu**.
</Info>

***

## Interactions

Each **menu** must have some interaction set. Additionally, certain settings may be unique depending on the chosen menu style and interaction type, so it’s worth being intentional about this setting. The available interactions for a Menu are listed below.

<Frame>
  <img src="https://mintcdn.com/standards/epOCltYvHgO46OhL/images/Interactions.png?fit=max&auto=format&n=epOCltYvHgO46OhL&q=85&s=ac827b55a2579d45f1cd576b5f16dd74" alt="Menu selected with contextual toolbar beside showing activated settings" width="2560" height="1280" data-path="images/Interactions.png" />
</Frame>

### Always open

The menu remains open and adjacent or over the page contents, and does not have a Closed state. This is fundamental to side or top bar menus.

<Frame>
  <img src="https://mintcdn.com/standards/epOCltYvHgO46OhL/images/auto_show_hide.gif?s=2746dee148fa922819b32dd69c643bfe" alt="Scrolling down a guidline page then back upto reveal a top menu" width="1200" height="600" data-path="images/auto_show_hide.gif" />
</Frame>

### Auto hide on scroll

The menu hides from a chosen direction when scrolling down, then reveals from that direction when scrolling back up.

### Open & close on click

Clicking on the menu icon triggers the menu to open and close.

### Open & close on hover

Hovering on the menu triggers it to open, hovering off the menu triggers it to close.

***

## Settings

While selecting a **Menu** element, the right sidebar will display the available settings for styling the container. Keep in mind: the **menu** is a parent containing everything within. These settings can be overridden in each breakpoint to allow for optimizations. For instance a sidebar style menu on desktop will most likely need a closed state on mobile.

### Menu states

**Menus** have a range of states that can be styled individually, or synced together. Both closed and open have rest and hover states.
