Open navClose nav

Menus

Known limitations

Menus are only supported with Hugo and Jekyll and don’t support multi-nested levels or linking to Hugo page bundles at the moment. Menus won’t show if you’re using Gatsby, Gridsome, Eleventy, VuePress, etc.

Menus allow content editors to easily manage existing menus in your site, such as site navigation and sidebars using a simple drag-and-drop interface.

https://res.cloudinary.com/forestry-io/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/22.png

Adding New Menus

Forestry will automatically display menus found in your site, and allow content editors to manage menu items from existing content in your site, or to external links on the internet.

Using with Hugo

The Menu Manager integrates directly with Hugo’s menu system. See Hugo’s documentation on setting up your first menu.

Menu entries linking to existing content on your site will be added to the front matter of that content.

Menu entries with external links will be added to your Hugo site config file.

Using with Jekyll

The Menu Manager integrates directly with the Jekyll Menus plugin.

Menu entries linking to existing content on your site will be added to the front matter of that content.

Menu entries with external links will be added to your menus data file located at /data/menus.yml.

NB. The Jekyll Menus plugin is not currently compatible with GitHub Pages as it is not a listed dependency.

Managing Menus

The Menu Manager allows you to add, reorganize, and remove menu items from existing menus.

https://res.cloudinary.com/forestry-io/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/27.png

Adding Menu Items

  1. Navigate to the Menus section of your site, found in the sidebar
  2. Click the menu you wish to update
  3. Click Add Link
  4. Provide a name for the menu item, and choose Internal to select an existing piece of content, or External to create a menu item to a publically accessible URL.

Modifying Menu Items

  1. Navigate to the Menus section of your site, found in the sidebar
  2. Click the menu you wish to update
  3. Click settings icon to the right of the menu item you wish to edit

Deleting Menu Items

  1. Navigate to the Menus section of your site, found in the sidebar
  2. Click the menu you wish to update
  3. Click trash icon to the right of the menu item you wish to delete

Reorganizing Menus

Menus can easily be reorganized using a drag-and-drop functionality. To reorganize a menu, drag a menu item from the drag indicator to the left of the menu item, and drop it in its new position.

https://res.cloudinary.com/forestry-io/image/fetch/c_limit,dpr_auto,f_auto,q_80,w_640/https://forestry.io/uploads/2018/01/26.png

If your site supports them, sub-menus can easily be created by dragging a menu item underneath another menu item! Give it a try!

Last updated on December 31, 2017