HUGO
News Docs Themes Community GitHub

ByDate

Returns the given page collection sorted by date in ascending order.

Syntax

PAGES.ByDate

Returns

page.Pages

When sorting by date, the value is determined by your site configuration, defaulting to the date field in front matter.

{{ range .Pages.ByDate }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

To sort in descending order:

{{ range .Pages.ByDate.Reverse }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}