Radical Design Course by Jack McDade

From the creator of Statamic

Learn how to make your websites standout and be remembered.

Just exceptional. Thank you so much, Jack, you smashed it.

— Hugo, Developer

Collections Fieldtype

Allows you to choose one or more collections.

The Collections Fieldtype in action!

Usage

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

fields:
my_collections_field:
type: collections

Data Structure

The Collections fieldtype is a Relationship fieldtype, and will save the collections as their handles (the folder name).

listings:
- blog
- things

Templating

You're more than likely using this field as a way to dynamically display a collection.

Since the collection tag accepts a pipe-delimited list of collection names, you can join them together like this:

<ul>
{{ collection from="{listings|piped}" }}
<li>{{ title }}</li>
{{ /collection }}
</ul>

You can pass the values from the collections fieldtype to the collection tag like so:

<ul>
<statamic:collection
:from="$listings ?? []"
>
<li>{{ $title }}</li>
</statamic:collection>
</ul>
<ul>
<li>A blog entry</li>
<li>A thing entry</li>
<li>etc</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 dropdown.

Docs feedback

Submit improvements, related content, or suggestions through Github.

Betterify this page →