List Find
Runs on: Shared — pure logic, runs on the Streamerly backend or inside a chatbox overlay.
The List Find node searches a list for the first item that matches the given value. It gives you both the matched item itself and a routing output so you can branch your flow depending on whether anything was found.
For lists of plain strings or numbers, it compares values directly. For lists of objects (custom types), you can configure a Match Field in the node — when set, it compares the given value against that field on each object rather than the object as a whole. This makes it easy to look up a viewer by username, find a leaderboard entry by name, or locate a quote by its ID.
Three outputs are always available: item carries the found object (or null when nothing matched), while pass and fail route the flow depending on the result.
Inputs
| Name | Type | Description |
|---|---|---|
list | list | The list to search. |
value | any | The value to match against. When Match Field is set, this is compared to that field on each object. |
Outputs
| Name | Type | Description |
|---|---|---|
item | any | The first matching item, or null if no match was found. |
pass | any | The matching item, forwarded only when a match was found. |
fail | any | null, forwarded only when no match was found. |
Configuration
- Match Field: When the list contains custom objects, select the field name to compare against. Leave blank for primitive lists (strings, numbers).
Example
You have a leaderboard stored as a list of objects, each with a username and score field. When a viewer redeems a channel point reward, use List Find with Match Field set to username and the viewer's name as the value. If they are already on the board (pass), update their score. If they are not (fail), add them as a new entry with List Add Item.