PHPackages                             eminos/statamic-field-item-relationship - 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. eminos/statamic-field-item-relationship

ActiveStatamic-addon

eminos/statamic-field-item-relationship
=======================================

A Statamic addon that adds a Field Item Relationship fieldtype.

v2.0(3mo ago)45.1k↓45.3%1[1 issues](https://github.com/eminos/statamic-field-item-relationship/issues)MITPHPPHP ^8.3

Since Sep 29Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/eminos/statamic-field-item-relationship)[ Packagist](https://packagist.org/packages/eminos/statamic-field-item-relationship)[ RSS](/packages/eminos-statamic-field-item-relationship/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (8)Dependencies (3)Versions (10)Used By (0)

Statamic Field Item Relationship
================================

[](#statamic-field-item-relationship)

A Statamic addon that adds a Field Item Relationship fieldtype. With Field Item Relationship you can select a value from a source field's items. That source field could be a sibling or ancestor field (in the same blueprint), or come from a Global set.

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

[](#installation)

Install this addon using composer.

```
composer require eminos/statamic-field-item-relationship

```

Statamic support
----------------

[](#statamic-support)

Statamic versionAddon versionAddon branchStatamic 3-5`1.x``1.x`Statamic 6`2.x``main`Features
--------

[](#features)

- The source field could be a sibling or ancestor field, or come from a Global set.
- Set which key/field should be used as the select option label.
- Use string literal for advanced option label configuration.
- Choose what you want to save as the selected item.
    - Key/Index
    - Specified object key
    - Full item/object
- Comes with a Tag `{{ fir }}` to help you fetch the selected source field item.

Field configuration
-------------------

[](#field-configuration)

The field configuration will depend on the source field data type. Depending on if the source data is a simple array of strings, an array of objects or an individual object, different "Save as" options will be possible.

You will get a warning message in the field if the field configuration isn't compatible with the source field data.

Tag usage
---------

[](#tag-usage)

This fetches the source value from the configured source field in field "field\_item\_relationship\_field".

```
{{ fir:field_item_relationship_field }}
```

If the source value is an object you get its values like this.

```
{{ fir:field_item_relationship_field }}
    {{ text_field_1 }}
    {{ some_other_field }}
{{ /fir:field_item_relationship_field }}
```

Or by specifying the target field in the tag like this:

```
{{ fir:field_item_relationship_field:text_field_1 }}
```

Even nested fields work, like this:

```
{{ fir:field_item_relationship_field:some_field.child_field }}
```

You can also get Global fields:

```
{{ fir:global_set:field_item_relationship_field:nested.target.path }}
```

Another way is to use the field and path parameters:

```
{{ fir field="global_set:field_item_relationship_field" path="some_field.child_field" }}
```

Screenshots
-----------

[](#screenshots)

A few different examples. [![Screenshot of different source field types](docs/screenshot1.png)](docs/screenshot1.png)

The field configuration options. [![Screenshot of the field configuration](docs/screenshot2.png)](docs/screenshot2.png)

Possible improvements
---------------------

[](#possible-improvements)

- Multiselect
- More selection fieldtype options (in addition to the Select fieldtype)
- Support Assets fieldtype as source field.

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

48

—

FairBetter than 95% of packages

Maintenance76

Regular maintenance activity

Popularity28

Limited adoption so far

Community11

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 77.8% 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 ~107 days

Recently: every ~159 days

Total

9

Last Release

103d ago

Major Versions

v1.4.1 → v2.02026-02-05

### Community

Maintainers

![](https://www.gravatar.com/avatar/5f7b9b5acefc797c0c0cf24b4b05ce1f55e50a0c20e5bdbf647eae53b0a16fab?d=identicon)[eminos](/maintainers/eminos)

---

Top Contributors

[![eminos](https://avatars.githubusercontent.com/u/1682784?v=4)](https://github.com/eminos "eminos (14 commits)")[![fvanhove](https://avatars.githubusercontent.com/u/8086841?v=4)](https://github.com/fvanhove "fvanhove (2 commits)")[![geert-salamander](https://avatars.githubusercontent.com/u/134492646?v=4)](https://github.com/geert-salamander "geert-salamander (2 commits)")

---

Tags

statamicstatamic-addonstatamic-v3statamic-v4statamic-v5statamic-v6

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/eminos-statamic-field-item-relationship/health.svg)

```
[![Health](https://phpackages.com/badges/eminos-statamic-field-item-relationship/health.svg)](https://phpackages.com/packages/eminos-statamic-field-item-relationship)
```

###  Alternatives

[statamic/statamic

Statamic

824170.4k](/packages/statamic-statamic)[statamic-rad-pack/runway

Eloquently manage your database models in Statamic.

135192.6k5](/packages/statamic-rad-pack-runway)[statamic/ssg

Generate static sites with Statamic.

254302.4k](/packages/statamic-ssg)[statamic/eloquent-driver

Allows you to store Statamic data in a database.

125598.8k7](/packages/statamic-eloquent-driver)[statamic/seo-pro

65440.7k](/packages/statamic-seo-pro)[rias/statamic-redirect

28298.4k](/packages/rias-statamic-redirect)

PHPackages © 2026

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