---
url: https://gudhub.com/ru/docs/utils/merge-items/
title: "Merge Items\n                #"
description: "mergeItems is the method that is called to merge items by field or item ID. It allows to connect required fields with source one so that they can be changed fro"
lang: uk
updated: 2026-09-12T04:42:53.707Z
---

# Merge Items [#](https://gudhub.com/ru/docs/utils/merge-items/#merge-items)

**mergeItems** is the method that is called to merge items by field or item ID. It allows to connect required fields with source one so that they can be changed from the source item. You can merge items from the same application or different ones.

This method accepts three arguments:

| Name | Type | Description |
| :-- | :-- | :-- |
| sorceItems | `array` | _array of items that will be used to update items from destinationItems items array_ |
| destinationItems | `array` | _array of items that is going to be updated_ |
| mergeByFieldId | `string` | _field id by that items will be merged_ |

> Unlike the other arguments, `mergeByFieldId` is **not a mandatory argument**.

It replaces all fields with values in `destinationItems` by values from `sorceItems`. Necessary fields are defined by The required fields are determined by the ID of the field itself. If `destinationItems` does not have fields that `sorceItems` then they will be created there.

> Items from chunks have a history property in a field.

As a result, it returns an array of updated items.

## sorceItems [#](https://gudhub.com/ru/docs/utils/merge-items/#sorceitems)

Source items array contains the prepared objects with data that will be used for update and IDs by which the needed fields will be found.

Копировать

```json
[{
    "item_id": 2985285,
    "fields": [{
        "field_id": 645887,
        "field_value": "Dow",
        },{
        "field_id": 645888,
        "field_value": "Johana",
    }],
}]
```

Unlike others, `item_id` is optional property. It is necessary when `mergeByFieldId` has not been passed into the method. Because it will be used only in this situation.

## destinationItems [#](https://gudhub.com/ru/docs/utils/merge-items/#destinationitems)

This is an object array of application items. It can contain more than just the ones you plan to update. That is possible because of using field and item IDs.

Копировать

```json
[{
    "item_id": 2985284,
    "fields": [{
        "field_id": 645887,
        "field_value": "Dow",
        },{
        "field_id": 645888,
        "field_value": "John",
    }],
},
{
    "item_id": 2985285,
    "fields": [{
        "field_id": 645887,
        "field_value": "Owl",
        },{
        "field_id": 645888,
        "field_value": "Jonny",
    }],
}];
```

Unlike the previous case, here **item\_id** is a mandatory property.

## mergeByFieldId [#](https://gudhub.com/ru/docs/utils/merge-items/#mergebyfieldid)

As you already know, **mergeByFieldId** is an optional argument. It is used for comparing two items. If their values in the entered field are the same, the items will be merged.

Копировать

```js
gudhub.mergeItems(sorceItems, destinationItems, mergeByFieldId)
```

Instead, if you want to merge items regardless of their fields, do not pass `mergeByFieldId`.

Копировать

```js
gudhub.mergeItems(sorceItems, destinationItems)
```

## Examples [#](https://gudhub.com/ru/docs/utils/merge-items/#examples)

Followings are the examples of code for two situations:

-   Merge [by field ID](#by-field-id)
-   Merge [by item ID](#by-item-id)

### By Field ID [#](https://gudhub.com/ru/docs/utils/merge-items/#by-field-id)

In this example the item with ID _**2985284**_ will be updated:

Копировать

```js
import GudHub from '@gudhub/core';
const AUTHKEY =  "JKBSCBkjncvskldksjaksMoiu98TYUV//teek/34//oeffdgse";
const gudhub = await new GudHub(AUTHKEY);
const APPID = "27823";
const mergeByFieldId = "645887";

let destinationItems = [{
    "item_id": 2985284,
    "fields": [{
        "field_id": 645887,
        "field_value": "Dow",
        },{
        "field_id": 645888,
        "field_value": "John",
        }],
    },
    {
    "item_id": 2985285,
    "fields": [{
        "field_id": 645887,
        "field_value": "Dow",
        },{
        "field_id": 645888,
        "field_value": "Jonny",
    }],
}];

let sorceItems = [{
    "fields": [{
        "field_id": 645887,
        "field_value": "Dow",
        },{
        "field_id": 645888,
        "field_value": "Johana",
    }],
}];

let mergeByFieldId = 645887;

let mergedItems = gudhub.mergeItems(sorceItems, destinationItems, mergeByFieldId);

gudhub.updateItems(APPID, mergedItems, mergeByFieldId)
```

The result items:

Копировать

```json
[{
    "item_id": 2985284,
    "fields": [{ 
        "field_id": 645887, 
        "field_value": "Dow" 
        },{ 
        "field_id": 645888, 
        "field_value": "Johana" 
    }],
}]
```

### By Item ID [#](https://gudhub.com/ru/docs/utils/merge-items/#by-item-id)

In this example the item with ID _**2985285**_ will be updated:

Копировать

```js
import GudHub from '@gudhub/core';
const AUTHKEY =  "JKBSCBkjncvskldksjaksMoiu98TYUV//teek/34//oefghxfgh";
const gudhub = await new GudHub(AUTHKEY);
const APPID = "27823";

let destinationItems = [{
    "item_id": 2985284,
    "fields": [{
        "field_id": 645887,
        "field_value": "Dow",
        },{
        "field_id": 645888,
        "field_value": "John",
        }],
    },
    {
    "item_id": 2985285,
    "fields": [{
        "field_id": 645887,
        "field_value": "Owl",
        },{
        "field_id": 645888,
        "field_value": "Jonny",
    }],
}];

let sorceItems = [{
    "item_id": 2985285,
    "fields": [{
        "field_id": 645887,
        "field_value": "Dow",
        },{
        "field_id": 645888,
        "field_value": "Johana",
    }],
}];

let mergedItems = gudhub.mergeItems(sorceItems, destinationItems);

gudhub.updateItems(APPID, mergedItems)
```

The result items:

Копировать

```json
[{
    "item_id": 2985284,
    "fields": [{
        "field_id": 645887,
        "field_value": "Dow",
        },{
        "field_id": 645888,
        "field_value": "John",
    }],
},{
    "item_id": 2985285,
    "fields": [{ 
        "field_id": 645887, 
        "field_value": "Dow" 
        },{ 
        "field_id": 645888, 
        "field_value": "Johana" 
    }],
}]
```