Checks whether the given value matches any of the values of the array and excludes the event from the search result if it does not match any value.

ParameterTypeRequiredDefault ValueDescription
array[a]stringrequired   A string in the format of a valid array followed by []. A valid array can either be an identifier, a valid array followed by . and an identifier, or a valid array followed by an array index surrounded by square brackets. For example, for events with fields incidents[0], incidents[1], ... this would be incidents[].
valuestringrequired   The exact value of the array to search for.

[a] The parameter name array can be omitted.

Hide omitted argument names for this function

Show omitted argument names for this function

Hide negatable operation for this function

Show negatable operation for this function

A specific syntax applies for this query function, see Array Syntax for details.

Click + next to an example below to get the full details.

Aggregate Array Content

Check for Values in Array

Use array query filter array:contains() to check for a value in a flat array