> For the complete documentation index, see [llms.txt](https://docs.fortifiedid.se/pipes/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fortifiedid.se/pipes/valves/item/item-match-merge.md).

# Item Match Merge

Merge items that has a matching property into one.

This valve merges items with matching properties specified in the "property\_to\_match". Other items are left unmodified &#x20;

`Example when using propA as property_to_match`&#x20;

`Input:`

`{"id":"1","propA":"XYZ","propB":"one"}   {"id":"2","propA":"XYZ","propB":"two"} {"id":"3","propA":"XYZ","propB":"three"}` \
`{"id":"4","propA":"something else","propB":"four"} {"id":"5","propA":"another","propB":"five"}`

`Result:`

`{"id":"1","propA":"XYZ","propB":["one","two","three]} {"id":"4","propA":"something else","propB":"four"} {"id":"5","propA":"another","propB":"five"}`

## Configuration

{% hint style="info" %}
**Valve name:** `ItemMatchMerge | ItemsMatchMerge`
{% endhint %}

{% tabs %}
{% tab title="Properties" %}

<table><thead><tr><th width="169">Name</th><th width="262">Description</th><th width="144">Default value</th><th width="129" data-type="checkbox">Mandatory</th><th width="118" data-type="checkbox">Expanded</th></tr></thead><tbody><tr><td><code>property_to_match</code></td><td>Name of the property to merge if matching</td><td></td><td>true</td><td>false</td></tr></tbody></table>

{% endtab %}

{% tab title="Example" %}

```json
{
    "name": "ItemMatchMerge",
    "config": {
        "property_to_match": "propA"
    }
}
```

{% endtab %}
{% endtabs %}
