HUGO
News Docs Themes Community GitHub

collections.Last

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

Syntax

collections.Last N COLLECTION

Returns

any

Alias

last
{{ slice "a" "b" "c" | last 1 }} → [c]
{{ slice "a" "b" "c" | last 2 }} → [b c]

Given that a string is in effect a read-only slice of bytes, this function can be used to return the specified number of bytes from the end of the string:

{{ "abc" | last 1 }} → c
{{ "abc" | last 2 }} → bc

Note that a character may consist of multiple bytes:

{{ "Schön" | last 1 }} → n
{{ "Schön" | last 2 }} → \xb6n
{{ "Schön" | last 3 }} → ön

To use the collections.Last function with a page collection:

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

Set N to zero to return an empty collection:

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

Use last and where together:

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