Taxonomies Fieldtype
Allows you to choose one or more taxonomies.
Usage#
This fieldtype is used to view and select from a list of Taxonomies.
fields:
my_taxonomies_field:
type: taxonomies
Data Structure#
The Taxonomies fieldtype is a Relationship fieldtype, and will save the taxonomies as their handles.
taxonomies:
- genre
- cool_factor
Templating#
You're more than likely using this field as a way to dynamically display Terms from one or more Taxonomies.
The following example assumes max_items has been set to 1:
<ul>
{{ taxonomy :from="my_taxonomy_field" }}
<li>{{ title }}</li>
{{ /taxonomy }}
</ul>
<ul>
<statamic:taxonomy
:from="$my_taxonomy_field"
>
<li>{{ $title }}</li>
</statamic:taxonomy>
</ul>
<ul>
<li>Comedy</li>
<li>Drama</li>
<li>Dramedy</li>
</ul>
Options
max_items
integer
The maximum number of items that may be selected. Setting this to `1` will change the UI to a select dropdwon.
mode
string
Set the UI style for this field. Can be one of 'default' (Stack Selector), 'select' (Select Dropdown) or 'typeahead' (Typeahead Field).