# Menu page

<figure><img src="https://3723856256-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGnixyIfIYFWroNtVmZo6%2Fuploads%2Fgit-blob-19e8ac10e0959caafca34f07b9db6ee42f5af9d4%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>

## Overview

A dynamic menu container component that creates a multi-level navigation menu with hover and click interactions. Supports up to three levels of navigation (parent, child, and grandchild links) with customizable styling and optional thumbnail images for menu items. Uses Alpine.js for menu interaction handling and includes hover and focus states with configurable timing.

## Common use cases

* Create multi-level navigation menus with parent, child, and grandchild links
* Use consistent image sizes for navigation thumbnails (recommended 64px)
* Configure menu depth and content for optimal mobile usability
* Keep menu labels concise for better layout
* Test hover/click interactions across different devices
* Use dropdown icons for better UX when submenus are present

## Compatible blocks

The following blocks can be nested within this block:

* [Menu item](https://help.brickspacelab.com/slab/content/blocks/navigation/menus/menu-dropdown/menu-item)

## Block settings

### General

| Setting                | Description                                                                | Options                   |
| ---------------------- | -------------------------------------------------------------------------- | ------------------------- |
| Show advanced settings | Reveals 6 advanced options including enable dropdown icons, type, and more | Checkbox (default: false) |

### Content

| Setting | Description                | Options                               |
| ------- | -------------------------- | ------------------------------------- |
| Menu    | Select the menu to display | Link list picker (default: main-menu) |

### Parent links

| Setting               | Description                                       | Options                                                                                                                                                           |
| --------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family           | Font family for parent menu links                 | <p>• Standard<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when parent font size contains type--</p>                                                   |
| Font size             | Font size for parent menu links                   | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |
| Enable dropdown icons | Shows chevron icons for menu items with dropdowns | <p>Checkbox (default: true)<br><br>Visible when <strong>Show advanced settings</strong> is on</p>                                                                 |

### Child links

| Setting     | Description                      | Options                                                                                                                                                           |
| ----------- | -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family | Font family for child menu links | <p>• Standard<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when child font size contains type--</p>                                                    |
| Font size   | Font size for child menu links   | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |

### Grandchild links

| Setting     | Description                           | Options                                                                                                                                                           |
| ----------- | ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Font family | Font family for grandchild menu links | <p>• Standard<br>• Heading<br>• Subheading<br>• Accent<br><br>Visible when grandchild font size contains type--</p>                                               |
| Font size   | Font size for grandchild menu links   | <p>• Smaller<br>• Small<br>• Default (default)<br>• Big<br>• Bigger<br>• Heading 1<br>• Heading 2<br>• Heading 3<br>• Heading 4<br>• Heading 5<br>• Heading 6</p> |

### Page

These color settings appear in the theme editor when **Show advanced settings** is on.

| Setting            | Description                                              | Options                                                                                                                                                                                                                                                                   |
| ------------------ | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type               | Custom scheme vs preset surface colors                   | <p>• Custom<br>• Base (default)</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on and <strong>Enable inheritance</strong> is off</p>                                                                                                               |
| Color scheme       | Background and text pairing                              | <p>Color scheme picker<br><br>Visible when type is <strong>Custom</strong>, <strong>Show advanced settings</strong> is on, and <strong>Enable inheritance</strong> is off</p>                                                                                             |
| Color scheme       | Background and text pairing                              | <p>• Body background (default)<br>• Body foreground<br>• Accent 1–3<br>• Shade 1–3<br>• Blur<br>• Transparent</p><p><br><br>Visible when type is <strong>Base</strong>, <strong>Show advanced settings</strong> is on, and <strong>Enable inheritance</strong> is off</p> |
| Border color       | Menu page border                                         | <p>• Subtle (default)<br>• Strong<br>• None</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on, type is <strong>Base</strong>, and <strong>Enable inheritance</strong> is off</p>                                                                   |
| Enable inheritance | Inherit colors from the closest parent with a set scheme | <p>Checkbox (default: false)<br><br>Visible when <strong>Show advanced settings</strong> is on</p>                                                                                                                                                                        |

### Spacing

| Setting                 | Description                           | Options                                                                      |
| ----------------------- | ------------------------------------- | ---------------------------------------------------------------------------- |
| Enable padding          | Adds padding around the menu          | Checkbox (default: false)                                                    |
| Enable internal padding | Adds internal padding to menu content | Checkbox (default: true)                                                     |
| Gap size                | Spacing between menu items            | <p>• None<br>• Default (default)<br>• XS<br>• SM<br>• MD<br>• LG<br>• XL</p> |

### Display

| Setting    | Description                        | Options                                                                                                                            |
| ---------- | ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| Visibility | Controls when the block is visible | <p>• All (default)<br>• Mobile only<br>• Desktop only</p><p><br><br>Visible when <strong>Show advanced settings</strong> is on</p> |
