---
title: "merge by field · RUAL Documentation"
description: "will return the merged array matching using the match_key."
canonical: https://docs.rual.nl/block-types/array/array_merge_by_field
language: en
---

# merge by field

This block is part of the [`array`](https://docs.rual.nl/block-types/array) group and was last modified in core [`v14.0.3`](https://docs.rual.nl/core-versions/140003).

will return the merged array matching using the `match_key`.

- base `base_array` required `array`

- merge from `merge_from` required `array`

- base array field `base_array_key` required `value`

- merge array field `merge_array_key` required `value`

- merge match field `merge_matches_key` required `value`

- merge as array `merge_all_matches` `condition`

- remove _meta from merged `remove_meta_from_merge` `condition`

- array `array`

### Core Releases