Skip to main content
Checks whether the incoming value is a list rather than a single value. Use this to confirm that a field which should hold several entries, such as the lines on an order, the images on a product, or a set of tags, really does contain a collection before you try to process each entry. A single number, piece of text, or on/off value is not a list and does not match. Internally both a plain list (["a", "b"]) and a keyed object ({ "color": "red" }) are stored the same way, so by default both are accepted. Turn on the Strict setting when you specifically need an ordered list and want to reject keyed objects.

​
Fields

​
Sample data

This checks each entity’s lines field. With Strict off, any list-shaped value matches:
Incoming valueResult
["a", "b", "c"] (a list)Matches
{ "sku": "A1", "qty": 2 } (a keyed object)Matches
[] (an empty list)Matches
42 (a number)Does not match
"hello" (text)Does not match
null (no value)Does not match
With Strict on, the keyed object is rejected while plain lists still pass:
Incoming valueResult
["a", "b", "c"] (a list)Matches
[] (an empty list)Matches
{ "sku": "A1", "qty": 2 } (a keyed object)Does not match