HUGO
News Docs Themes Community GitHub

collections.First

Returns the given collection, limited to the first N elements.

Syntax

collections.First N COLLECTION

Returns

any

Alias

first
{{ range first 5 .Pages }}
  {{ .Render "summary" }}
{{ end }}

Set N to zero to return an empty collection.

{{ $emptyPageCollection := first 0 .Pages}}

Use first and where together.

{{ range where .Pages "Section" "articles" | first 5 }}
  {{ .Render "summary" }}
{{ end }}