# Add Menu Items

This guide explains how to add new links to a menu on your Varbase site.

## Steps to Add a Menu Item

1. **Navigate to the menu.**
   * Go to **Structure > Menus** in the admin navigation sidebar, or navigate to `/admin/structure/menu`.
   * Find the menu you want to add a link to (e.g., Main navigation, Footer).
   * Click **Edit menu** to open the menu management page.
2. **Add a new link.**
   * Click the **Add link** button at the top of the menu management page.
3. **Configure the menu item.**

   Fill in the following fields:

   * **Menu link title**: The text that will be displayed for the link. Choose a clear, concise title that tells visitors what they will find when they click.
   * **Link**: The URL for the link. You can enter:
     * An internal path (e.g., `/about-us` or start typing a page title for autocomplete suggestions).
     * An external URL (e.g., `https://example.com`).
     * `<front>` to link to the homepage.
     * `<nolink>` to create a non-clickable parent item (useful for dropdown menu headings).
   * **Enabled**: Check this box to make the menu item visible on the site. Uncheck to hide it without deleting it.
   * **Description**: An optional description that appears as a tooltip when visitors hover over the link.
   * **Show as expanded**: If checked, the menu item's children will always be displayed (useful for dropdown menus).
   * **Parent link**: Select a parent item to nest this link under an existing menu item, creating a hierarchical structure. Leave as the top-level menu to place it at the root level.
   * **Weight**: A number that determines the order of the item relative to its siblings. Lower numbers appear first. You can also adjust order later using drag and drop.
4. **Save the menu item.**
   * Click **Save** to add the link to the menu.

## Adding Menu Items from Content

You can also add a content item to a menu directly from the content editing form:

1. Open the content item for editing.
2. Expand the **Menu settings** section (usually in the sidebar).
3. Check **Provide a menu link**.
4. Fill in the menu link title and select the parent item.
5. Save the content. The menu link will be created automatically.

## Tips

* Keep menu titles short and descriptive. Visitors should understand what to expect from each link.
* Limit the depth of menu nesting. Two levels (parent and child) is generally sufficient for most navigation menus. Deeply nested menus can be difficult for visitors to use.
* Use `<nolink>` for parent items that serve only as category headings in dropdown menus.
* Test the menu after adding items to verify that links work correctly and the menu structure is logical.
* Remember to clear the cache if menu changes do not appear immediately on the live site.


---

# 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.varbase.vardot.com/content-designers/content-structure/menu-management/add-menu-items.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.