list contains

FEEL built-in function · FEEL list functions

list contains(list, element)

Returns true if the list contains the element. Unlike the = operator, it can also test for null.

The element may be null, so list contains also tests whether a list has a null entry. Comparison is by value with no type conversion.

Parameters

Parameter	Type	Description
list	list	the list to search
element	any	the value to look for; may be null

Examples

list contains([1, 2, 3], 2)

true Try it ↑

list contains([1, null, 3], null)

true Try it ↑

Edge cases and null handling

list contains([1, 2, 3], "2")

false Try it ↑

A string is never equal to a number.

list contains([1.0, 2], 1)

true Try it ↑

list contains([[1, 2], [3]], [1, 2])

true Try it ↑

Nested lists compare by content.

list contains([date("2026-01-01")], date("2026-01-01"))

true Try it ↑

list contains([], 1)

false Try it ↑

list contains(null, 1)

null Try it ↑

A null list gives null in FEEL; B-FEEL returns false.

Part of FEEL list functions: how positions, nulls and single values behave across all of them, aggregating over lists of contexts, and every function side by side.

Related functions

index of · count

Defined by the OMG DMN 1.6 specification, chapter 10.3.4 (built-in functions).