Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
80 lines (52 sloc) 3.67 KB

Element List Field Type for Craft CMS

Join the chat at Software License Build Status Coverage Status Quality Score Total Downloads

Element List introduces a table-based element relational field type; perfect for large or growing element relations.



This plugin requires Craft CMS 3.0 or later.


Choose one of the following ways to add Element List to your project:

  1. Composer:

    Simply run the following command from your project root:

    composer require flipboxfactory/craft-element-lists
  2. Craft CMS Plugin Store:

    Within your Craft CMS project admin panel, navigate to the 'Plugin Store' and search for 'Element List'. Installation is a button click away.

Once the plugin is included in your project, navigate to the Control Panel, go to Settings → Plugins and click the “Install” button for Element List.

Additional information (including pricing) can be found in the Plugin Store.


Element List brings the familiar element 'index' view to your fields. Built for large relation sets, Element List provides content publishers a filterable, table based view to related elements. Element List is as easy to configure as native relationships.

Here are some of the features at a glance:

  • Add/Remove relations in real time
  • Handles large relational sets (hundreds/thousands)
  • Sortable list view
  • Searchable list view
  • Developer friendly


Similar to native relational fields, an Element List field returns an Element Query Interface.

Loop through field relations:

    {% for relatedElement in element.fieldHandle.all() %}
        <li>{{ }} - {{ relatedElement.someCustomField }}</li>
    {% endfor %}

Element Lists also supports eager-loading. Simply follow the native nested sets eager loading documentation.


Element Source Filter

Inline Element Edit

Select Modal

Input Remove Action

Field Settings


You can’t perform that action at this time.