> For the complete documentation index, see [llms.txt](https://docs.emobiq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.emobiq.com/emobiq-client/006-actions-and-visual-logic/action-reference/cordova/array/unshift.md).

# unshift

## Description

Adds new elements to the beginning of an array and returns the updated array.

## Input / Parameter

| Name  | Description                                                                        | Input Type  | Default | Options | Required                    |
| ----- | ---------------------------------------------------------------------------------- | ----------- | ------- | ------- | --------------------------- |
| var   | The name of the array to add new elements to. The return will affect the variable. | String/Text | -       | -       | Partial (Yes if no 'data'.) |
| data  | The array to add new elements to.                                                  | Array/List  | -       | -       | Partial (Yes if no 'var'.)  |
| value | Element to be added to the array.                                                  | String/Text | -       | -       | Yes                         |

## Output

| Description                             | Output Type |
| --------------------------------------- | ----------- |
| The updated array with the items added. | Array/List  |

## Callback

N/A

## Video

Coming Soon.

## Example

Coming Soon.

### Steps

Coming Soon.

### Result

Coming Soon.

## Links