Skip to main content
List Selector takes a list and outputs one item from it, chosen by index, at random, or the first item. The list holds one type at a time: text, image, video, audio, or file. The node locks to whatever type first connects to it, and flags a validation error if a different type is connected afterward.

​
When to use

  • A/B pick from a set of variants
  • Choose a random creative option
  • Pick one result out of a batch from a loop
Common pattern: split_text → list_selector → generate_text. Pick one image out of a batch: generate_image (loop, 4 results) → list_selector (By index, index 2) → upscale_image.

​
Inputs

​
text | image | video | audio | file
required
The list to pick from. Required, accepts an array of one type, whichever type first connects to this input.

​
Outputs

​
text | image | video | audio | file
The selected item. The node card and the focus dialog preview it natively: an image thumbnail, a playable video or audio clip, the text itself, or a filename chip for files. You can see what you picked instead of reading a URL.

​
Configuration

​
string
default:"manual"
How the item is chosen. manual selects the first item, index selects by position, and random picks one at random.
​
number
default:"0"
Zero-based position to select. Used only when selectionMode is index.