> For the complete documentation index, see [llms.txt](https://cgps.gitbook.io/data-flo/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cgps.gitbook.io/data-flo/reference-guide/prepend-to-list.md).

# 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>](/data-flo/reference-guide/append-to-list.md) adaptor. If you wish to add multiple values, use the [<mark style="color:purple;">`append-lists`</mark> ](/data-flo/reference-guide/append-lists.md)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> ](/data-flo/reference-guide/sort-list.md)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.