---
url: https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/
title: "Get Item By Item Ref\n                #"
description: "Get Item By Item Ref is a node that allows you to get any element by its reference, indicated in some field. The work of this node based on the Item Reference."
lang: uk
updated: 2026-09-12T04:37:51.838Z
---

# Get Item By Item Ref [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#get-item-by-item-ref)

**Get Item By Item Ref** is a node that allows you to get any element by its reference, indicated in some field. The work of this node based on the [Item Reference](https://gudhub.com/ru/docs/gh-elements/item-reference/). It is the reference that consists of application ID and item ID. At this reference you can get access to the item.

![Get item  by ref node](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Automation_Nodes/automation-nodes/get-items-by-item-ref-node.jpg "Get item by ref")

## Inputs [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#inputs)

The current node contains only default input sockets.

### Default Input Sockets [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#default-input-sockets)

The current node can accept items in two ways:

-   Accepts item
-   Accept reference of item

This means that you can **pass the complete** item with the desired [Item Reference](https://gudhub.com/ru/docs/gh-elements/item-reference/) to the node _or_ **pass only its reference**, previously obtained in the [Item Destructor](https://gudhub.com/ru/docs/automation-nodes/item-destructor/).

| Name | Data Type | Description |
| :-- | :-- | :-- |
| Items | `item` | _accepts items with needed reference field_ |
| Item ID | `value` | _accepts item reference of the source item_ |

### Additional Input Sockets [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#additional-input-sockets)

The current node have no additional input sockets.

## Outputs [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#outputs)

As with the input sockets, this node has only default output sockets.

### Default Output Sockets [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#default-output-sockets)

The only output socket returns the item gotten by its reference.

| Name | Data Type | Description |
| :-- | :-- | :-- |
| Items | `item` | _returns item by reference_ |

### Additional Output Sockets [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#additional-output-sockets)

There are no settings to add any additional output sockets.

## Options [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#options)

The current node has quite small number of settings. Almost all of them set up the source of the item reference.

![Default settings of get item by item ref node](https://bitbucket.org/AAtlas/gudhub-documentation/raw/master/Automation_Nodes/automation-nodes/get-item-by-item-ref-default-settings.jpg "Get item by item ref settings")

| Name | Description |
| :-- | :-- |
| Application | allows to select application with item reference; [details...](#application) |
| Field | allows to select the field with item reference; [details...](#field) |
| Notes | allows to leave any notes in the node settings; [details...](#notes) |

### Application [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#application)

For this node, you need to select an application that contains fields with references to the items you need.

### Field [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#field)

This is a field that contains references to the required items. The field must be [**Item Reference** element](https://gudhub.com/ru/docs/gh-elements/item-reference/).

### Notes [#](https://gudhub.com/ru/docs/automation-nodes/get-item-by-item-ref/#notes)

This field is created to leave some notes in the node settings.
