# Insert List Element

## Overview

![The Insert List Element Node.](https://1553081948-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FU990HLHWA30dTfELtDUK%2Fuploads%2Fgit-blob-a419bf1b1e3417fda1fdd8b037c7b564eb6313f4%2Finsertlistelementnode20241.png?alt=media)

The **Insert List Element Node** inserts an element into a **List** at the specified `Index`. All elements after the inserted element will have an updated index of *i + 1*. Each element consists of two parts: the icon and the text.

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

## Inputs

| Input             | Type         | Description                                                                               |
| ----------------- | ------------ | ----------------------------------------------------------------------------------------- |
| *Pulse Input* (►) | **Pulse**    | A standard **Input Pulse**, to trigger the execution of the **Node**.                     |
| `Object ID`       | **ObjectID** | The **List** the user wishes to insert an element to.                                     |
| `Index`           | **Int**      | The index that the element will be inserted at.                                           |
| `Icon Path`       | **String**   | The path on the user's local machine which locates the desired icon image to be inserted. |
| `Text`            | **String**   | The text of the element to be inserted.                                                   |

## 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. |

## See Also

* [**Remove List Element**](https://docs.incari.com/incari-studio/toolbox/incari/list2d/removelistelement)
