# \#menu

**URL:** https://discourse.gohugo.io/tag/menu/98.md

[Latest](https://discourse.gohugo.io/latest.md) · [Categories](https://discourse.gohugo.io/categories.md) · [Tags](https://discourse.gohugo.io/tags.md)

---

## [Deep merging for menus?](https://discourse.gohugo.io/t/deep-merging-for-menus/57162)

<div class="topic-metadata">

**Author:** [@lhenze](https://discourse.gohugo.io/u/lhenze)\
**Replies:** 5\
**Last updated:** [May 18, 2026, 7:20pm UTC](https://discourse.gohugo.io/t/deep-merging-for-menus/57162 "2026-05-18T19:20:55Z")

</div>

Hi! Should \_merge = deep work with theme modules, for menus? I have a bunch of sites which all use a theme module. There is a config/\_default dir, for the sites and the theme, and inside each, a hugo.toml and menus.t…

---

## [Today I learned: you need to add pageRef to your hugo menus if you want to style the current/trail menu item](https://discourse.gohugo.io/t/today-i-learned-you-need-to-add-pageref-to-your-hugo-menus-if-you-want-to-style-the-current-trail-menu-item/55877)

<div class="topic-metadata">

**Author:** [@manu96](https://discourse.gohugo.io/u/manu96)\
**Replies:** 7\
**Last updated:** [September 6, 2025, 7:59pm UTC](https://discourse.gohugo.io/t/today-i-learned-you-need-to-add-pageref-to-your-hugo-menus-if-you-want-to-style-the-current-trail-menu-item/55877 "2025-09-06T19:59:28Z")

</div>

Just a quick reminder for everyone who wants to add an active class to the current menu item. Maybe you want to use IsMenuCurrent or HasMenuCurrent to check for the currently active (or in case of a nested menu, current…

---

## [Multilingual Menu & URL Issue with Blowfish Theme](https://discourse.gohugo.io/t/multilingual-menu-url-issue-with-blowfish-theme/54962)

<div class="topic-metadata">

**Author:** [@wilonweb](https://discourse.gohugo.io/u/wilonweb)\
**Replies:** 5\
**Last updated:** [June 3, 2025, 12:48pm UTC](https://discourse.gohugo.io/t/multilingual-menu-url-issue-with-blowfish-theme/54962 "2025-06-03T12:48:04Z")

</div>

Can’t get language switcher to appear + “Articles” menu doesn’t link to /posts/ Hi everyone, I’m using the Blowfish theme and running into two issues: The language switcher doesn’t appear in the top menu (even though…

---

## [The presence of a content/index.html file makes a menu item incorrect](https://discourse.gohugo.io/t/the-presence-of-a-content-index-html-file-makes-a-menu-item-incorrect/54294)

<div class="topic-metadata">

**Author:** [@voyajer](https://discourse.gohugo.io/u/voyajer)\
**Replies:** 16\
**Last updated:** [April 10, 2025, 2:20pm UTC](https://discourse.gohugo.io/t/the-presence-of-a-content-index-html-file-makes-a-menu-item-incorrect/54294 "2025-04-10T14:20:10Z")

</div>

hugo env: hugo v0.126.2+extended linux/amd64 BuildDate=2024-07-18T00:00:00+00:00 VendorInfo=Fedora:0.126.2-3.fc41 GOOS=“linux” GOARCH=“amd64” GOVERSION=“go1.23rc1” github.com/sass/libsass=“3.6.5” github.com/webmpro…

---

## [Issues with installing Zen theme](https://discourse.gohugo.io/t/issues-with-installing-zen-theme/54184)

<div class="topic-metadata">

**Author:** [@Ndimby\_Ramaronera](https://discourse.gohugo.io/u/Ndimby_Ramaronera)\
**Replies:** 5\
**Last updated:** [April 1, 2025, 2:17pm UTC](https://discourse.gohugo.io/t/issues-with-installing-zen-theme/54184 "2025-04-01T14:17:25Z")

</div>

Hello everyone, I’ve been trying to set up the Zen theme for my Hugo website, but I’m facing two main issues: Missing Content: After following the installation steps, some expected content sections are not appearing …

---

## [LoveIt theme: menu not working specifically on Home page](https://discourse.gohugo.io/t/loveit-theme-menu-not-working-specifically-on-home-page/54139)

<div class="topic-metadata">

**Author:** [@pauloo](https://discourse.gohugo.io/u/pauloo)\
**Replies:** 2\
**Last updated:** [March 28, 2025, 9:55pm UTC](https://discourse.gohugo.io/t/loveit-theme-menu-not-working-specifically-on-home-page/54139 "2025-03-28T21:55:13Z")

</div>

Hey there! I am starting to build a website using the LoveIt theme and I ran into a weird problem: the theme-switch button does not work on the home page, but works on other pages. Also, when on mobile mode, the menu dro…

---

## [Current page properties are set incorrectly](https://discourse.gohugo.io/t/current-page-properties-are-set-incorrectly/49919)

<div class="topic-metadata">

**Author:** [@popovich](https://discourse.gohugo.io/u/popovich)\
**Replies:** 18\
**Last updated:** [January 30, 2025, 9:41am UTC](https://discourse.gohugo.io/t/current-page-properties-are-set-incorrectly/49919 "2025-01-30T09:41:30Z")

</div>

My navigation and URL references go nuts – and I can’t see the pattern which might need fixing. Here is the navigation template: \<div class="d-none d-md-flex mr-2"\> \<ul class="nav-main"\> {{ $currentPage := . }} {…

---

## [Section menu items with no name are not rendered](https://discourse.gohugo.io/t/section-menu-items-with-no-name-are-not-rendered/52778)

<div class="topic-metadata">

**Author:** [@pHneute](https://discourse.gohugo.io/u/pHneute)\
**Replies:** 4\
**Last updated:** [December 19, 2024, 10:28pm UTC](https://discourse.gohugo.io/t/section-menu-items-with-no-name-are-not-rendered/52778 "2024-12-19T22:28:19Z")

</div>

I am migrating my website from Hugo 0.120.4 to 0.139.4. Suddenly some of my menu items don’t appear anymore. I defined the menu in site configuration like this: \[menus\] \[\[menus.main\]\] pageRef = '/about' weight …

---

## [Name property in front matter for menu](https://discourse.gohugo.io/t/name-property-in-front-matter-for-menu/52512)

<div class="topic-metadata">

**Author:** [@Papatechy](https://discourse.gohugo.io/u/Papatechy)\
**Replies:** 2\
**Last updated:** [November 24, 2024, 1:42am UTC](https://discourse.gohugo.io/t/name-property-in-front-matter-for-menu/52512 "2024-11-24T01:42:04Z")

</div>

I have menu defined in front matter and it works but picks the linktitle attribute not the name. Is there an issue or I am doing something wrong? What I see in menu that shows up is ‘Website title 2’ not Home. Front mat…

---

## [Right way to make a custom table of contents?](https://discourse.gohugo.io/t/right-way-to-make-a-custom-table-of-contents/52425)

<div class="topic-metadata">

**Author:** [@Apreche](https://discourse.gohugo.io/u/Apreche)\
**Replies:** 2\
**Last updated:** [November 15, 2024, 3:24am UTC](https://discourse.gohugo.io/t/right-way-to-make-a-custom-table-of-contents/52425 "2024-11-15T03:24:35Z")

</div>

Normally if you make a menu of the pages on a site, Hugo provides a single—potentially hierarchical—list. It’s easy to get something looking like this. Copyright Dedication Preface Table of Contents Blog Technology Ar…

---

## [Main Menu url being re-written incorrectly](https://discourse.gohugo.io/t/main-menu-url-being-re-written-incorrectly/50298)

<div class="topic-metadata">

**Author:** [@marshalc](https://discourse.gohugo.io/u/marshalc)\
**Replies:** 12\
**Last updated:** [June 20, 2024, 8:43am UTC](https://discourse.gohugo.io/t/main-menu-url-being-re-written-incorrectly/50298 "2024-06-20T08:43:57Z")

</div>

Hi all, I think this might be a bug, but I’m not sure if it’s just that I’m doing something wrong… Scenario: Internal Gitlab server, with Pages publishing setup Projects use Hugo+Docsy to build their html documentati…

---

## [Multiple menus messes up navigation bar formatting](https://discourse.gohugo.io/t/multiple-menus-messes-up-navigation-bar-formatting/49031)

<div class="topic-metadata">

**Author:** [@Sarah\_Helmbrecht](https://discourse.gohugo.io/u/Sarah_Helmbrecht)\
**Replies:** 4\
**Last updated:** [March 24, 2024, 8:00pm UTC](https://discourse.gohugo.io/t/multiple-menus-messes-up-navigation-bar-formatting/49031 "2024-03-24T20:00:51Z")

</div>

I’m completely reorganizing my Hugo site, and as part of that, I’ve created 3 separate menus. There is a main homepage with nothing but a header, and the main menu navigation bar is on that page. When you click on either…

---

## [The menu generated by \`sectionPagesMenu\` is not detecting Children items and does not seem to be Recursive in nature](https://discourse.gohugo.io/t/the-menu-generated-by-sectionpagesmenu-is-not-detecting-children-items-and-does-not-seem-to-be-recursive-in-nature/48572)

<div class="topic-metadata">

**Author:** [@anandkp](https://discourse.gohugo.io/u/anandkp)\
**Replies:** 11\
**Last updated:** [March 1, 2024, 7:35pm UTC](https://discourse.gohugo.io/t/the-menu-generated-by-sectionpagesmenu-is-not-detecting-children-items-and-does-not-seem-to-be-recursive-in-nature/48572 "2024-03-01T19:35:32Z")

</div>

Hi everyone! Hugo noob here, this is my first post so a few words first… Loving the system and finding the documentation to be REALLY robust - so, to all maintainers/advanced users, THANK YOU! Second thing before I dive…

---

## [Custom sidebar (left nav menu) entries](https://discourse.gohugo.io/t/custom-sidebar-left-nav-menu-entries/48437)

<div class="topic-metadata">

**Author:** [@Josh019](https://discourse.gohugo.io/u/Josh019)\
**Replies:** 5\
**Last updated:** [February 25, 2024, 6:04am UTC](https://discourse.gohugo.io/t/custom-sidebar-left-nav-menu-entries/48437 "2024-02-25T06:04:13Z")

</div>

I’m relatively new to Hugo, and using the Zdoc theme. The title of each doc page is taken from the md file metadata, as in this example: title: "Deploy Core Components on Kubernetes and OpenShift" This also becomes th…

---

## [Menu Entry Methods](https://discourse.gohugo.io/t/menu-entry-methods/47704)

<div class="topic-metadata">

**Author:** [@Anthony\_Henson](https://discourse.gohugo.io/u/Anthony_Henson)\
**Replies:** 2\
**Last updated:** [January 4, 2024, 9:10am UTC](https://discourse.gohugo.io/t/menu-entry-methods/47704 "2024-01-04T09:10:15Z")

</div>

According to this documentation: MENU ENTRY METHODS we can include a params key to attach additional information to the entry. My menus.en.toml \[\[main\]\] weight = 4 name = "Resources" hasChildren = true \[\[main\]\] …

---

## [Lists of categories on front page](https://discourse.gohugo.io/t/lists-of-categories-on-front-page/46836)

<div class="topic-metadata">

**Author:** [@mikaelstaldal](https://discourse.gohugo.io/u/mikaelstaldal)\
**Replies:** 1\
**Last updated:** [October 26, 2023, 8:06pm UTC](https://discourse.gohugo.io/t/lists-of-categories-on-front-page/46836 "2023-10-26T20:06:34Z")

</div>

I am trying migrate a WordPress blog to Hugo: current blog is here . How can I include lists of categories and monthly archives on the front page? Like there is in the right column on the WordPress blog. My code is her…

---

## [\`IsMenuCurrent\` not working with using \`sectionPagesMenu\`](https://discourse.gohugo.io/t/ismenucurrent-not-working-with-using-sectionpagesmenu/46687)

<div class="topic-metadata">

**Author:** [@bbaovanc](https://discourse.gohugo.io/u/bbaovanc)\
**Replies:** 7\
**Last updated:** [October 17, 2023, 1:54am UTC](https://discourse.gohugo.io/t/ismenucurrent-not-working-with-using-sectionpagesmenu/46687 "2023-10-17T01:54:43Z")

</div>

I’m using sectionPagesMenu in config.yaml to automatically create menu entries for my top level sections. The navbar entry for the section is supposed to be highlighted (“active”) if the current page either is the sectio…

---

## [What If I want to add span tag in name?](https://discourse.gohugo.io/t/what-if-i-want-to-add-span-tag-in-name/46409)

<div class="topic-metadata">

**Author:** [@heinhtetkyaw](https://discourse.gohugo.io/u/heinhtetkyaw)\
**Replies:** 4\
**Last updated:** [September 27, 2023, 3:58am UTC](https://discourse.gohugo.io/t/what-if-i-want-to-add-span-tag-in-name/46409 "2023-09-27T03:58:44Z")

</div>

Continuing the discussion from Adding an icon next to menu item: what if I want to add something span tag in {{- $text := print $icon " " .Name | safeHTML -}} \<li\>\<a href="link"\>\<i\>\</i\>\<span\>Name\</span\>\</a\>\</li\> ?

---

## [How put the URL base?](https://discourse.gohugo.io/t/how-put-the-url-base/45920)

<div class="topic-metadata">

**Author:** [@wilonweb](https://discourse.gohugo.io/u/wilonweb)\
**Replies:** 4\
**Last updated:** [August 28, 2023, 2:38pm UTC](https://discourse.gohugo.io/t/how-put-the-url-base/45920 "2023-08-28T14:38:20Z")

</div>

Hello I make my firest theme. On my file hugo-blank-theme-v3\\hugo-blank-theme-v3\\themes\\sandbox\\layouts\\partials\\header.html I got the line of code of my “logo navabar” \<a href="/" title="home" class="navbar-item"\> …

---

## [How to modify specify menu on dev env?](https://discourse.gohugo.io/t/how-to-modify-specify-menu-on-dev-env/45336)

<div class="topic-metadata">

**Author:** [@razon](https://discourse.gohugo.io/u/razon)\
**Replies:** 2\
**Last updated:** [July 18, 2023, 7:22am UTC](https://discourse.gohugo.io/t/how-to-modify-specify-menu-on-dev-env/45336 "2023-07-18T07:22:37Z")

</div>

Hi, I’m creating a monorepo for multiple sites, I run multiple sites on local, and I want to change some menu URLs to local development URLs. For example $ tree config config/ \_default/ menu.yaml development/ …

---

## [Can't get a very simple menu to work](https://discourse.gohugo.io/t/cant-get-a-very-simple-menu-to-work/44318)

<div class="topic-metadata">

**Author:** [@Ton\_van\_Bart](https://discourse.gohugo.io/u/Ton_van_Bart)\
**Replies:** 18\
**Last updated:** [May 11, 2023, 6:04pm UTC](https://discourse.gohugo.io/t/cant-get-a-very-simple-menu-to-work/44318 "2023-05-11T18:04:55Z")

</div>

Hi, I’m new to Hugo, and trying to build a very simple site with a “Home” page and a section “News” with blog posts. I want to have a menu with these two options and highlight the active menu section, but after hours of …

---

## [External link logo on menu item](https://discourse.gohugo.io/t/external-link-logo-on-menu-item/44292)

<div class="topic-metadata">

**Author:** [@imtdb](https://discourse.gohugo.io/u/imtdb)\
**Replies:** 6\
**Last updated:** [May 10, 2023, 5:31pm UTC](https://discourse.gohugo.io/t/external-link-logo-on-menu-item/44292 "2023-05-10T17:31:13Z")

</div>

Hi everyone. I am wondering how can I add this type of external link logo to my menu. This is the blog from where the screenshot is from: https://arduin.io/ And this is my blog: https://tadeodonegana.com/ There i am …

---

## [How to write the site configuration in yaml format for the multi-level menu?](https://discourse.gohugo.io/t/how-to-write-the-site-configuration-in-yaml-format-for-the-multi-level-menu/44081)

<div class="topic-metadata">

**Author:** [@ZhangChengLin](https://discourse.gohugo.io/u/ZhangChengLin)\
**Replies:** 4\
**Last updated:** [April 26, 2023, 6:59pm UTC](https://discourse.gohugo.io/t/how-to-write-the-site-configuration-in-yaml-format-for-the-multi-level-menu/44081 "2023-04-26T18:59:10Z")

</div>

I have read the docs excuse me 1. How should multi-level related menus be written in multiple languages? in yaml format for example: demo menu, there are login and registration menus below, Login menu, with acco…

---

## [Defining and accessing root objects from configDir](https://discourse.gohugo.io/t/defining-and-accessing-root-objects-from-configdir/43850)

<div class="topic-metadata">

**Author:** [@ColonelBlimp](https://discourse.gohugo.io/u/ColonelBlimp)\
**Replies:** 9\
**Last updated:** [April 12, 2023, 7:58am UTC](https://discourse.gohugo.io/t/defining-and-accessing-root-objects-from-configdir/43850 "2023-04-12T07:58:18Z")

</div>

I want to define menus in a separate config file: /config/\_default/menus.toml, but I am struggling to understand how to define a multi-level menu within the menus.toml file and how to access this menu within a template. …