gohugoio-hugo/docs/content/en/methods/taxonomy/Get.md

title, description, categories, keywords, action, toc

title	description	categories	keywords	action	toc
Get	Returns a slice of weighted pages to which the given term has been assigned.			related returnType signatures page.WeightedPages TAXONOMY.Get TERM	true

The Get method on a Taxonomy object returns a slice of weighted pages to which the given term has been assigned.

{{% include "methods/taxonomy/_common/get-a-taxonomy-object.md" %}}

Get the weighted pages

Now that we have captured the "genres" Taxonomy object, let's get the weighted pages to which the "suspense" term has been assigned:

{{ $weightedPages := $taxonomyObject.Get "suspense" }}

The above is equivalent to:

{{ $weightedPages := $taxonomyObject.suspense }}

But, if the term is not a valid identifier, you cannot use the chaining syntax. For example, this will throw an error because the identifier contains a hyphen:

{{ $weightedPages := $taxonomyObject.my-genre }}

You could also use the index function, but the syntax is more verbose:

{{ $weightedPages := index $taxonomyObject "my-genre" }}

To inspect the data structure:

<pre>{{ jsonify (dict "indent" "  ") $weightedPages }}</pre>

Example

With this template:

{{ $weightedPages := $taxonomyObject.Get "suspense" }}
{{ range $weightedPages }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}

Hugo renders:

<h2><a href="/books/jamaica-inn/">Jamaica inn</a></h2>
<h2><a href="/books/death-on-the-nile/">Death on the nile</a></h2>
<h2><a href="/books/and-then-there-were-none/">And then there were none</a></h2>