---
title: "list_contains function in Strata | Oplema"
description: "Check whether a list contains a value, returning true or false. For example, list_contains([1, 2, NULL], 1) returns true."
url: "https://oplema.com/docs/strata/functions/list-contains"
updated: "2026-11-04"
---

# list\_contains

Check whether a list contains a value.

Also available as array\_contains, array\_has, list\_has.

## Try an expression

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

### Expression

```
list_contains([1, 2, NULL], 1)
```

### Result

```
true
```

To use your own data, replace the example values with column names. Keep format strings and other options as written.

This Boolean expression also works in [Filter](https://oplema.com/docs/strata/prep/filter) custom mode. For the literal inputs above, the row goes to the True output. A missing result goes to False.

Try it live in Formula

Result
| id | result |
| --- | --- |
| 1 | true |

## Arguments and types

```
list_contains(list, element)
```

**list**

List

**element**

Any value

Supported signatures (1)

```
list_contains(list: T[], element: T) → BOOLEAN
```

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\_position

Find the position of a value in a list, where 1 is the first item. Returns a missing value if it isn't found.

](https://oplema.com/docs/strata/functions/list-position)[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\_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\_has\_any

Check whether two lists share at least one item. Missing values are ignored.

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

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

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