ByParam
Returns the given page collection sorted by the given parameter in ascending order.
- Syntax
- PAGES.ByParam PARAM
- Returns
- page.Pages
If the given parameter is not present in front matter, Hugo will use the matching parameter in your project configuration if present.
{{ range .Pages.ByParam "author" }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}To sort in descending order:
{{ range (.Pages.ByParam "author").Reverse }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}If the targeted parameter is nested, access the field using dot notation:
{{ range .Pages.ByParam "author.last_name" }}
<h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}Last updated:
February 25, 2026
:
Merge commit '0c2fa2460f485e0eca564dcccf36d34538374922' (b0d3364f1)
Improve this page