---
title: "list_aggregate function in Strata | Oplema"
description: "Run an aggregate function such as sum or max over the values in a list and return the result. For example, list_aggregate([1, 2, NULL], 'min') returns 1."
url: "https://oplema.com/docs/strata/functions/list-aggregate"
updated: "2026-11-04"
---

# list\_aggregate

Run a named aggregate function, such as min or sum, over the items in a list.

Also available as aggregate, array\_aggr, array\_aggregate, list\_aggr.

## Try an expression

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

### Expression

```
list_aggregate([1, 2, NULL], 'min')
```

### Result

```
1
```

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

## Arguments and types

```
list_aggregate(list, function_name, ...)
```

**list**

List

**function\_name**

Text

Supported signatures (1)

```
list_aggregate(list: ANY[], function_name: VARCHAR, ...: ANY) → 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\_filter

Keep the list items for which a lambda expression returns true. The lambda result must be convertible to BOOLEAN, and the output has the same type as the input list.

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

Reduces all elements of the input list into a single scalar value by executing the lambda function on a running result and the next list element. The lambda function has an optional initial\_value argument.

](https://oplema.com/docs/strata/functions/list-reduce)[list\_has\_all

Check whether a list contains every item of a second list. Missing values are ignored.

](https://oplema.com/docs/strata/functions/list-has-all)[list\_intersect

Return the distinct items that appear in both lists.

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

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

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