PHPackages                             flipboxfactory/craft-element-lists - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. flipboxfactory/craft-element-lists

ActiveCraft-plugin[Utility & Helpers](/categories/utility)

flipboxfactory/craft-element-lists
==================================

Simple Element lists

3.3.0(4y ago)69.5k3[8 issues](https://github.com/flipboxfactory/craft-element-lists/issues)proprietaryPHPCI failing

Since May 1Pushed 4y ago2 watchersCompare

[ Source](https://github.com/flipboxfactory/craft-element-lists)[ Packagist](https://packagist.org/packages/flipboxfactory/craft-element-lists)[ RSS](/packages/flipboxfactory-craft-element-lists/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (10)Dependencies (7)Versions (24)Used By (0)

Element List Field Type for Craft CMS
=====================================

[](#element-list-field-type-for-craft-cms)

[![Join the chat at https://gitter.im/flipboxfactory/craft-element-lists](https://camo.githubusercontent.com/e69e5ad60ea1ad873e5d1e6b78f239f792cad286aa424ca05d140eb2338504d4/68747470733a2f2f6261646765732e6769747465722e696d2f666c6970626f78666163746f72792f63726166742d656c656d656e742d6c697374732e737667)](https://gitter.im/flipboxfactory/craft-element-lists?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)[![Software License](https://camo.githubusercontent.com/7bb09e7c53051d10bf37beea24a0396b80d87c85615a6c9db63a65f14c6cc977/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d50726f70726965746172792d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Build Status](https://camo.githubusercontent.com/b7474dcc053bd1cb0762a94bef323ea049deb0e818a832a8c41c759c6160e6d3/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f666c6970626f78666163746f72792f63726166742d656c656d656e742d6c697374732f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.com/flipboxfactory/craft-element-lists)[![Coverage Status](https://camo.githubusercontent.com/32901558706a8115f0a4965293590383d0288bb92bc6eb89f0231597758bb26c/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f666c6970626f78666163746f72792f63726166742d656c656d656e742d6c697374732e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/flipboxfactory/craft-element-lists/code-structure)[![Quality Score](https://camo.githubusercontent.com/9bfeffda05e5c03875df2fcf646a9b1c71cd1ff77526c136f0a7230e0f76895d/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f666c6970626f78666163746f72792f63726166742d656c656d656e742d6c697374732e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/flipboxfactory/craft-element-lists)[![Total Downloads](https://camo.githubusercontent.com/99e73de7074f127ec7662b5ea6696038122c73b42dd2e45139b7819e75995a73/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666c6970626f78666163746f72792f63726166742d656c656d656e742d6c697374732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/flipboxfactory/craft-element-lists)

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

[![Screenshot](resources/screenshots/field.png)](resources/screenshots/field.png)

New in Version 3
----------------

[](#new-in-version-3)

Element List field(s) now return a [Relationship Interface](https://github.com/flipboxfactory/craft-element-lists/blob/develop/src/relationships/RelationshipInterface.php) (not the traditional [Element Query Interface](https://docs.craftcms.com/v3/dev/element-queries/#executing-element-queries)). As a result, if your app manipulates relationships in a custom manner (php/plugins/modules) some changes are required. Specifically, manipulating relations should use the `add`, `remove`, and `save` methods on the [Relationship Interface](https://github.com/flipboxfactory/craft-element-lists/blob/develop/src/relationships/RelationshipInterface.php) (examples are below).

**Note: Accessing field data using the legacy [Element Query Interface](https://docs.craftcms.com/v3/dev/element-queries/#executing-element-queries) via TWIG is still supported; no code change are required.**

Requirements
------------

[](#requirements)

This plugin requires Craft CMS 3.2.x thru Craft 3.3.x.

Installation
------------

[](#installation)

Choose one of the following ways to add [Element List](https://plugins.craftcms.com/element-lists) 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](https://plugins.craftcms.com/element-lists)' and search for '[Element List](https://plugins.craftcms.com/element-lists)'. 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](https://plugins.craftcms.com/element-lists).

Additional information (including pricing) can be found in the [Plugin Store](https://plugins.craftcms.com/element-lists).

Features
--------

[](#features)

[Element List](https://plugins.craftcms.com/element-lists) brings the familiar element 'index' view to your fields. Built for large relation sets, [Element List](https://plugins.craftcms.com/element-lists) provides content publishers a filterable, table based view to related elements. [Element List](https://plugins.craftcms.com/element-lists) 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

### Templating *(version 1 & 2)*

[](#templating-version-1--2)

Similar to [native relational fields](https://docs.craftcms.com/v3/relations.html), an [Element List](https://plugins.craftcms.com/element-lists) field returns an [Element Query Interface](https://docs.craftcms.com/v3/dev/element-queries/#executing-element-queries).

Loop through field relations:

```

    {% for relatedElement in element.fieldHandle.all() %}
        {{ relatedElement.id }} - {{ relatedElement.someCustomField }}
    {% endfor %}

```

### Templating *(version 3)*

[](#templating-version-3)

An [Element List](https://plugins.craftcms.com/element-lists) field returns an [Relationship Interface](https://github.com/flipboxfactory/craft-element-lists/blob/develop/src/relationships/RelationshipInterface.php) which is the primary interface for accessing and managing relationships.

Loop through field relations:

```

    {% for relatedElement in element.fieldHandle.collection.all() %}
        {{ relatedElement.id }} - {{ relatedElement.someCustomField }}
    {% endfor %}

```

The legacy query operations from version 1 & 2 (above) are still accessible (but discouraged).

### Collections *(new in Version 3)*

[](#collections-new-in-version-3)

In version 3 you'll begin to work with a [Collection](https://laravel.com/docs/5.8/collections). These are super handy classes with various [methods](https://laravel.com/docs/5.8/collections#available-methods) to interact with your data.

### Eager Loading

[](#eager-loading)

Element Lists also supports eager-loading. Simply follow the native [nested sets eager loading documentation](https://docs.craftcms.com/v3/dev/eager-loading-elements.html#eager-loading-nested-sets-of-elements).

### Developers

[](#developers)

Native relationship fields are not developer friendly; we aim to fix that in version 3 by introducing the concept of a [Relationship Interface](https://github.com/flipboxfactory/craft-element-lists/blob/develop/src/relationships/RelationshipInterface.php).
Here are a few examples:

```
// Add two new users to the list
Entry::findOne(['id' => 1])
    ->userListField
    ->add([
        'nate@flipboxdigital.com',
        'damien@flipboxdigital.com'
    ])
    ->save();
```

```
// Remove one user and add another
Entry::findOne(['id' => 1])
    ->userListField
    ->remove('nate@flipboxdigital.com')
    ->add('damien@flipboxdigital.com')
    ->save();
```

```
// Remove all users
Entry::findOne(['id' => 1])
    ->userListField
    ->clear()
    ->save();
```

In the above examples, we're saving the relationships immediately; however if you make changes to your relationships and don't save, when the element is saved the relationship changes will also be saved.

### Screenshots

[](#screenshots)

[![Element Source Filter](resources/screenshots/input-source-filter.png)](resources/screenshots/input-source-filter.png)

[![Inline Element Edit](resources/screenshots/input-inline-element-edit.png)](resources/screenshots/input-inline-element-edit.png)

[![Select Modal](resources/screenshots/input-select-modal.png)](resources/screenshots/input-select-modal.png)

[![Input Remove Action](resources/screenshots/input-remove-action.png)](resources/screenshots/input-remove-action.png)

[![Field Settings](resources/screenshots/field-settings.png)](resources/screenshots/field-settings.png)

Credits
-------

[](#credits)

- [Flipbox Digital](https://github.com/flipbox)

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance0

Infrequent updates — may be unmaintained

Popularity26

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity73

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~77 days

Recently: every ~105 days

Total

19

Last Release

1530d ago

Major Versions

1.0.2 → 2.0.02019-03-26

2.2.1 → 3.0.02019-10-09

### Community

Maintainers

![](https://www.gravatar.com/avatar/f88ef7075dc76a34393f80402c30cc8eec30d5134835314136669a68b8ce817f?d=identicon)[nateiler](/maintainers/nateiler)

---

Top Contributors

[![nateiler](https://avatars.githubusercontent.com/u/1892443?v=4)](https://github.com/nateiler "nateiler (86 commits)")

---

Tags

yii2Craftelementscraft cmsflipbox

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/flipboxfactory-craft-element-lists/health.svg)

```
[![Health](https://phpackages.com/badges/flipboxfactory-craft-element-lists/health.svg)](https://phpackages.com/packages/flipboxfactory-craft-element-lists)
```

###  Alternatives

[verbb/formie

The most user-friendly forms plugin for Craft.

101372.9k40](/packages/verbb-formie)[craftcms/ckeditor

Edit rich text content in Craft CMS using CKEditor.

48359.1k52](/packages/craftcms-ckeditor)[verbb/tablemaker

Create customizable and user-defined table fields.

40168.8k1](/packages/verbb-tablemaker)[fruitstudios/searchit

Configure powerful custom filters for an enhanced search experience in the Craft CMS control panel.

2840.6k](/packages/fruitstudios-searchit)[verbb/hyper

A user-friendly links field for Craft.

24130.9k9](/packages/verbb-hyper)[verbb/social-poster

Automatically post entries to social media.

918.5k](/packages/verbb-social-poster)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)