---
title: "list_first function in Strata | Oplema"
description: "Get the first value in a list. For example, list_first([3,3,9]) returns 3. A missing list gives a missing result. Works in a Strata Formula or Filter."
url: "https://oplema.com/docs/strata/functions/list-first"
updated: "2026-11-04"
---

# list\_first

Calculate the first value from the values in a list.

## Try an expression

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

### Expression

```
list_first([3,3,9])
```

### Result

```
3
```

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 | 3 |

## Arguments and types

```
list_first(l)
```

**l**

Any value

Supported signatures (1)

```
list_first(l: ANY)
```

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

## Things to know

If the first argument is missing, the result is NULL.

## Related functions

[list\_bool\_or

Calculate whether any non-missing value is true from the values in a list.

](https://oplema.com/docs/strata/functions/list-bool-or)[list\_last

Calculate the last value from the values in a list.

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

Calculate the largest value from the values in a list.

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

Calculate the smallest value from the values in a list.

](https://oplema.com/docs/strata/functions/list-min)

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

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