> 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/append-lists.md).

# append-lists

## Description

<mark style="color:purple;">`append-lists`</mark> *adaptor combines values from two lists into one.*

The `list` output includes values from the `first list`, followed by values from the `second list`. Use the [<mark style="color:purple;">`append-to-list`</mark> ](/data-flo/reference-guide/append-to-list.md)adaptor or the [<mark style="color:purple;">`prepend-to-list`</mark>](/data-flo/reference-guide/prepend-to-list.md) adaptor to add a single value to an existing list.

Final list can be connected to the [<mark style="color:purple;">`sort-list`</mark> ](/data-flo/reference-guide/sort-list.md)adaptor to change the ordering of values in the list.

## Inputs

**`first list`**\
Type: `list`\
Required: Yes\
The list to which the second will be appended.

**`second list`**\
Type: `list`\
Required: Yes\
The list that will be appended to the first list.

## Outputs

**`list`**\
Type: `list`\
A list containing values from both lists.

## Examples

### Example 1: Default behaviour.

#### Inputs:

`first list`:

1. Jan
2. Feb
3. Mar

`second list`:

1. Apr
2. May
3. Jun

#### Outputs:

`new list`:

1. Jan
2. Feb
3. Mar
4. Apr
5. May
6. Jun

-> Combined values from two lists.

## Use cases

* Appending lists will help users to consolidate information to identify available and/or missing values
* Appending lists may be necessary for consolidation or merging of historical records/ datasets.
* Appending lists allows for adjustment of included values without modifying the original dataset.