hugo/docs/content/en/functions/collections/Shuffle.md

title, description, categories, keywords, params, aliases

title	description	categories	keywords	params	aliases
collections.Shuffle	Returns a slice by randomizing the element order of the given slice.		random	functions_and_methods aliases returnType signatures shuffle []any collections.Shuffle SLICE	/functions/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 0.149.0 />}}

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