hugo/docs/content/en/methods/menu/Limit.md
Bjørn Erik Pedersen 5fd1e74903
Merge commit '9b0050e9aabe4be65c78ccf292a348f309d50ccd' as 'docs'
```
git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash
```

Closes #11925
2024-01-27 10:48:57 +01:00

890 B

title description categories keywords action
Limit Returns the given menu, limited to the first N entries.
related returnType signatures
navigation.Menu
MENU.Limit N

The Limit method returns the given menu, limited to the first N entries.

Consider this menu definition:

{{< code-toggle file=hugo >}} menus.main name = 'Services' pageRef = '/services' weight = 10

menus.main name = 'About' pageRef = '/about' weight = 20

menus.main name = 'Contact' pageRef = '/contact' weight = 30 {{< /code-toggle >}}

To sort the entries by name, and limit to the first 2 entries:

<ul>
  {{ range .Site.Menus.main.ByName.Limit 2 }}
    <li><a href="{{ .URL }}">{{ .Name }}</a></li>
  {{ end }}
</ul>

Hugo renders this to:

<ul>
  <li><a href="/about/">About</a></li>
  <li><a href="/contact">Contact</a></li>
</ul>