# Get Dictionary Element

## Overview

![The Get Dictionary Element Node.](https://926825830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKQhJdUBr7YQzfIwmpAZ9%2Fuploads%2Fgit-blob-edce76ffe6152b7cb06dd02daf60a2760c0280bf%2Fgetdictionaryelementupdatedimage.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/2022.1/overview#scopes): **Project**, **Scene**, **Function**, **Prefab**.

## Attributes

![The Get Dictionary Element Node Attributes.](https://926825830-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKQhJdUBr7YQzfIwmpAZ9%2Fuploads%2Fgit-blob-e141a8b756fe1d3854028d0d3a0ca9c94acea8c3%2Fgetdictionaryelementattributes.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 `Index` **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. |
| `Index (*Key name*)` | **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/2022.1/toolbox/dictionary/dictionary-value)
* [**Set Dictionary Element**](https://docs.incari.com/incari-studio/2022.1/toolbox/dictionary/set-dictionary-element)