# prepend-to-list

## Description

<mark style="color:purple;">`prepend-to-list`</mark> *adaptor adds a single new value to the beginning of an existing list*.

If you wish to add a value to the end of a list, use the [<mark style="color:purple;">`append-to-list`</mark>](https://cgps.gitbook.io/data-flo/reference-guide/append-to-list) adaptor. If you wish to add multiple values, use the [<mark style="color:purple;">`append-lists`</mark> ](https://cgps.gitbook.io/data-flo/reference-guide/append-lists)adaptor.

## Inputs

**`list`**\
Type: `list`\
Required: Yes\
The list to which the value will be prepended.

**`value`**\
Type: `text`\
Required: Yes\
The value to be prepended to the list.

## Outputs

**`list`**\
Type: `list`\
A list with the value prepended.

## Examples

### Example 1: Default behaviour.

Inputs:

`list`:

1. green
2. blue

`value`:

1. red

#### Outputs:

`list`:

1. red
2. green
3. blue

-> Prepended value `red` to the existing list.

## Use Cases

* After using the [<mark style="color:purple;">`sort-list`</mark> ](https://cgps.gitbook.io/data-flo/reference-guide/sort-list)adaptor, add a missing element to the beginning of the list.
* Adding new values to lists allows for adjustment of included values without modifying the original dataset.