collections.Shuffle

Returns a slice by randomizing the element order of the given slice.

Syntax: collections.Shuffle SLICE
Returns: []any
Alias: shuffle

{{ collections.Shuffle (slice "a" "b" "c") }} → [b a c]

The result will vary from one build to the next.

To render an unordered list of 5 random pages from a page collection:

<ul>
  {{ $p := site.RegularPages }}
  {{ range $p | collections.Shuffle | first 5 }}
    <li><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></li>
  {{ end }}
</ul>

New in v0.149.0

Using the collections.D function for the same task is significantly faster.

Last updated: October 10, 2026 : theme: Migrate aliases to a redirects data file (b732eba6c)

Improve this page