> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orisu.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Selector

> Pick a single item from a list of text, images, video, audio, or files.

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

<ParamField body="List" type="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.
</ParamField>

## Outputs

<ParamField body="Item" type="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.
</ParamField>

## Configuration

<ParamField body="selectionMode" type="string" default="manual">
  How the item is chosen. `manual` selects the first item, `index` selects by position, and `random` picks one at random.
</ParamField>

<ParamField body="index" type="number" default="0">
  Zero-based position to select. Used only when `selectionMode` is `index`.
</ParamField>