Taxonomies Fieldtype // Statamic Docs

The Taxonomies Fieldtype in action!

Usage

This fieldtype is used to view and select from a list of Taxonomies.

fields:
  my_taxonomies_field:
    type: taxonomies

The Taxonomies fieldtype is a Relationship fieldtype, and will save the taxonomies as their handles.

taxonomies:
  - genre
  - cool_factor

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>

integer

The maximum number of items that may be selected. Setting this to 1 will change the UI to a select dropdwon.

string

Set the UI style for this field. Can be one of 'default' (Stack Selector), 'select' (Select Dropdown) or 'typeahead' (Typeahead Field).