# Get Dictionary Element

## Overview

![The Get Dictionary Element Node.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-6f1e7aaea5483a1c018b89559de267e02f321910%2Fgetdictionaryelementnodeupdate.png?alt=media)

**Get Dictionary Element** is used for retrieving elements from a **Dictionary**. It receives as input the **Dictionary** from which the elements will be retrieved and the `Keys` of the desired elements. The outputs are the received **Dictionary** and the `Values` associated with the given `Keys`.

[**Scope**](https://docs.incari.com/incari-studio/2023.2/overview#scopes): **Project**, **Scene**, **Function**, **Prefab**.

## Attributes

![The Get Dictionary Element Node Attributes.](https://2561100106-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff6JZovzOqBctA4C1o76u%2Fuploads%2Fgit-blob-8b9668245e2c5fe03d87bf93fac248e6f1ed733c%2Fgetdictionaryelementattributesupdate.png?alt=media)

### Miscellaneous

`Inputs/Outputs` - The number of elements you want to get from the **Dictionary**. Each element has the following **Attributes**:

| Attribute   | Type          | Description                                                                                                 |
| ----------- | ------------- | ----------------------------------------------------------------------------------------------------------- |
| `Key`       | **String**    | The `Key` of the element you wish to return if none is provided to the `Key: KEYNAME` **Input** **Socket**. |
| `Data Type` | **Drop-down** | The `Data Type` of the `Value` that will be returned.                                                       |

## Inputs

| Input             | Type           | Description                                                            |
| ----------------- | -------------- | ---------------------------------------------------------------------- |
| *Pulse Input* (►) | **Pulse**      | A standard **Input Pulse**, to trigger the execution of the **Node**.  |
| `Dictionary`      | **Dictionary** | The **Dictionary** from which the desired element/s will be retrieved. |
| `Key: KEYNAME`    | **String**     | The `Key` of the element you wish to return.                           |

## Outputs

| Output             | Type                                          | Description                                                                                                                            |
| ------------------ | --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------- |
| *Pulse Output* (►) | **Pulse**                                     | A standard **Output Pulse**, to move onto the next **Node** along the **Logic Branch**, once this **Node** has finished its execution. |
| `Dictionary`       | **Dictionary**                                | The **Dictionary** provided to the **Input** **Socket**.                                                                               |
| `Value`            | *Defined in the* `Data Type` ***Attribute***. | The **Output** value retrieved from the **Dictionary**.                                                                                |

## See Also

* [**Dictionary Value**](https://docs.incari.com/incari-studio/2023.2/toolbox/dictionary/dictionary-value)
* [**Set Dictionary Element**](https://docs.incari.com/incari-studio/2023.2/toolbox/dictionary/set-dictionary-element)