https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/Recent content in Menu entry methods on HugoHugo -- gohugo.ioenhttps://v0-122-0--gohugoio.netlify.app/methods/menu-entry/children/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/children/Use the Children method when rendering a nested menu. With this site configuration: hugo. yaml   toml   json   menus: main: - name: Products pageRef: /product weight: 10 - name: Product 1 pageRef: /products/product-1 parent: Products weight: 1 - name: Product 2 pageRef: /products/product-2 parent: Products weight: 2 [menus] [[menus.main]] name = 'Products' pageRef = '/product' weight = 10 [[menus.main]] name = 'Product 1' pageRef = '/products/product-1' parent = 'Products' weight = 1 [[menus.https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/haschildren/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/haschildren/Use the HasChildren method when rendering a nested menu. With this site configuration: hugo. yaml   toml   json   menus: main: - name: Products pageRef: /product weight: 10 - name: Product 1 pageRef: /products/product-1 parent: Products weight: 1 - name: Product 2 pageRef: /products/product-2 parent: Products weight: 2 [menus] [[menus.main]] name = 'Products' pageRef = '/product' weight = 10 [[menus.main]] name = 'Product 1' pageRef = '/products/product-1' parent = 'Products' weight = 1 [[menus.https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/identifier/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/identifier/The Identifier method returns the identifier property of the menu entry. If you define the menu entry automatically, it returns the page’s section. hugo. yaml   toml   json   menus: main: - identifier: about name: About pageRef: /about weight: 10 - identifier: contact name: Contact pageRef: /contact weight: 20 [menus] [[menus.main]] identifier = 'about' name = 'About' pageRef = '/about' weight = 10 [[menus.main]] identifier = 'contact' name = 'Contact' pageRef = '/contact' weight = 20 { "menus": { "main": [ { "identifier": "about", "name": "About", "pageRef": "/about", "weight": 10 }, { "identifier": "contact", "name": "Contact", "pageRef": "/contact", "weight": 20 } ] } } This example uses the Identifier method when querying the translation table on a multilingual site, falling back the name property if a matching key in the translation table does not exist:https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/keyname/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/keyname/In this menu definition, the second entry does not contain an identifier, so the Identifier method returns its name property instead: hugo. yaml   toml   json   menus: main: - identifier: about name: About pageRef: /about weight: 10 - name: Contact pageRef: /contact weight: 20 [menus] [[menus.main]] identifier = 'about' name = 'About' pageRef = '/about' weight = 10 [[menus.main]] name = 'Contact' pageRef = '/contact' weight = 20 { "menus": { "main": [ { "identifier": "about", "name": "About", "pageRef": "/about", "weight": 10 }, { "name": "Contact", "pageRef": "/contact", "weight": 20 } ] } } This example uses the KeyName method when querying the translation table on a multilingual site, falling back the name property if a matching key in the translation table does not exist:https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/menu/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/menu/{{ range .Site.Menus.main }} {{ .Menu }} → main {{ end }} Use this method with the IsMenuCurrent and HasMenuCurrent methods on a Page object to set “active” and “ancestor” classes on a rendered entry. See this example.https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/name/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/name/If you define the menu entry automatically, the Name method returns the page’s LinkTitle, falling back to its Title. If you define the menu entry in front matter or in site configuration, the Name method returns the name property, falling back to the page’s LinkTitle, then to its Title. <ul> {{ range .Site.Menus.main }} <li><a href="{{ .URL }}">{{ .Name }}</a></li> {{ end }} </ul>https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/page/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/page/Regardless of how you define menu entries, an entry associated with a page has access to its methods. In this menu definition, the first two entries are associated with a page, the last entry is not: hugo. yaml   toml   json   menus: main: - pageRef: /about weight: 10 - pageRef: /contact weight: 20 - name: Hugo url: https://gohugo.io weight: 30 [menus] [[menus.main]] pageRef = '/about' weight = 10 [[menus.https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/params/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/params/When you define menu entries in site configuration or in front matter, you can include a params key to attach additional information to the entry. For example: hugo. yaml   toml   json   menus: main: - name: About pageRef: /about weight: 10 - name: Contact pageRef: /contact weight: 20 - name: Hugo params: rel: external url: https://gohugo.io weight: 30 [menus] [[menus.main]] name = 'About' pageRef = '/about' weight = 10 [[menus.https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/parent/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/parent/With this menu definition: hugo. yaml   toml   json   menus: main: - name: Products pageRef: /product weight: 10 - name: Product 1 pageRef: /products/product-1 parent: Products weight: 1 - name: Product 2 pageRef: /products/product-2 parent: Products weight: 2 [menus] [[menus.main]] name = 'Products' pageRef = '/product' weight = 10 [[menus.main]] name = 'Product 1' pageRef = '/products/product-1' parent = 'Products' weight = 1 [[menus.main]] name = 'Product 2' pageRef = '/products/product-2' parent = 'Products' weight = 2 { "menus": { "main": [ { "name": "Products", "pageRef": "/product", "weight": 10 }, { "name": "Product 1", "pageRef": "/products/product-1", "parent": "Products", "weight": 1 }, { "name": "Product 2", "pageRef": "/products/product-2", "parent": "Products", "weight": 2 } ] } } This template renders the nested menu, listing the parent property next each of the child entries:https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/post/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/post/In this site configuration we enable rendering of emoji shortcodes, and add emoji shortcodes before (pre) and after (post) each menu entry: hugo. yaml   toml   json   enableEmoji: true menus: main: - name: About pageRef: /about post: ':point_left:' pre: ':point_right:' weight: 10 - name: Contact pageRef: /contact post: ':arrow_left:' pre: ':arrow_right:' weight: 20 enableEmoji = true [menus] [[menus.main]] name = 'About' pageRef = '/about' post = ':point_left:' pre = ':point_right:' weight = 10 [[menus.https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/pre/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/pre/In this site configuration we enable rendering of emoji shortcodes, and add emoji shortcodes before (pre) and after (post) each menu entry: hugo. yaml   toml   json   enableEmoji: true menus: main: - name: About pageRef: /about post: ':point_left:' pre: ':point_right:' weight: 10 - name: Contact pageRef: /contact post: ':arrow_left:' pre: ':arrow_right:' weight: 20 enableEmoji = true [menus] [[menus.main]] name = 'About' pageRef = '/about' post = ':point_left:' pre = ':point_right:' weight = 10 [[menus.https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/title/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/title/If you define the menu entry automatically, the Title method returns the page’s LinkTitle, falling back to its Title. If you define the menu entry in front matter or in site configuration, the Name method returns the title property, falling back to the page’s LinkTitle, then to its Title. <ul> {{ range .Site.Menus.main }} <li><a href="{{ .URL }}">{{ .Title }}</a></li> {{ end }} </ul>https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/url/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/url/For menu entries associated with a page, the URL method returns the page’s RelPermalink, otherwise it returns the entry’s url property. <ul> {{ range .Site.Menus.main }} <li><a href="{{ .URL }}">{{ .Name }}</a></li> {{ end }} </ul>https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/weight/Mon, 01 Jan 0001 00:00:00 +0000https://v0-122-0--gohugoio.netlify.app/methods/menu-entry/weight/If you define the menu entry automatically, the Weight method returns the page’s Weight. If you define the menu entry in front matter or in site configuration, the Weight method returns the weight property, falling back to the page’s Weight. In this contrived example, we limit the number of menu entries based on weight: <ul> {{ range .Site.Menus.main }} {{ if le .Weight 42 }} <li><a href="{{ .URL }}">{{ .Name }}</a></li> {{ end }} {{ end }} </ul>