---
title: "list_concat function in Strata | Oplema"
description: "Join two or more lists into one list, keeping the values in their original order. Write it as list_concat(list1, list2) in a Strata Formula or Filter."
url: "https://oplema.com/docs/strata/functions/list-concat"
updated: "2026-11-04"
---

# list\_concat

Join lists into one list. Missing inputs are skipped, while the || operator returns a missing value if either input is missing.

Also available as array\_cat, array\_concat, list\_cat.

## Try an expression

In [Formula](https://oplema.com/docs/strata/prep/formula), enter the expression and set Output type to **VARCHAR**.

### Expression

```
list_concat([2, 3], [4, 5, 6], [7])
```

### Result

```
'[2, 3, 4, 5, 6, 7]'
```

The expression returns `INTEGER[]`. Formula stores it as `VARCHAR` in this example. To use your own data, replace the example values with column names. Keep format strings and other options as written.

Try it live in Formula

Result
| id | result |
| --- | --- |
| 1 | \[2, 3, 4, 5, 6, 7\] |

## Arguments and types

```
list_concat(...)
```

Supported signatures (1)

```
list_concat(...: ANY[]) → ANY[]
```

The result type can depend on the input types. See DuckDB for the full argument rules.

## Things to know

### With a missing first argument

```
list_concat(NULL::INTEGER[], [4, 5, 6], [7])
```

'\[4, 5, 6, 7\]'

## Related functions

[list\_distance

Calculates the Euclidean distance between two points with coordinates given in two inputs lists of equal length.

](https://oplema.com/docs/strata/functions/list-distance)[list\_zip

Pair up items by position from two or more lists, returning a list of structs. Shorter lists are padded with missing values unless you set truncate, which stops at the shortest list.

](https://oplema.com/docs/strata/functions/list-zip)[array\_cosine\_distance

Computes the cosine distance between two arrays of the same size. The array elements can not be NULL. The arrays can have any size as long as the size is the same for both arguments.

](https://oplema.com/docs/strata/functions/array-cosine-distance)[array\_cosine\_similarity

Computes the cosine similarity between two arrays of the same size. The array elements can not be NULL. The arrays can have any size as long as the size is the same for both arguments.

](https://oplema.com/docs/strata/functions/array-cosine-similarity)

[Browse lists & arrays](https://oplema.com/docs/strata/functions#lists-&-arrays) [DuckDB documentation](https://duckdb.org/docs/current/sql/functions/list.html#list_concatlist_1-list_n)

Function metadata from DuckDB, used under the [MIT license](https://github.com/duckdb/duckdb/blob/v1.5.4/LICENSE).
