List Selector Nodes

List Selector Nodes pick items from a list using flexible selection strategies. After splitting text into a list, use a List Selector to choose exactly which items to process — the first three, a random one, a specific range, or items at specific positions.

What is a List Selector Node?

The List Selector takes a list of items (from a Split Text Node) and outputs selected items as text. It supports five selection modes, each useful for different scenarios.

Inputs & Outputs

Port	Direction	Type	Description
input	In	List	List of items from Split Text Node
output	Out	Text	Selected items (joined by separator) → Text, Scene, Reference Image, AI Voice, Concatenator, HTML, JSON Parser, If/Else, AI If/Else, Canvas, Network Image, Network Video, Google Drive Export

Inspector Controls

Selection Mode

Mode	Description	Example
Single	Pick one item at a specific index	Index 2 → third item
Multiple	Pick items at specific indices	Indices 0, 2, 4 → 1st, 3rd, 5th items
Range	Pick items from index A to B	Range 1-3 → 2nd, 3rd, 4th items
Random	Pick N random items	Random 1 → one surprise item
First/Last N	Pick first or last N items	First 3 → first three items

Output Separator

How to join multiple selected items in the output text:

Newline (default) — each item on its own line
Comma — items separated by commas
Space — items separated by spaces
Custom — any separator text

How to Use

Connect a Split Text Node to the List Selector input
Choose a selection mode
Configure the mode parameters (index, count, range)
Set the output separator
Connect to downstream nodes (Text, Scene, etc.)

Workflow Examples

Random Headlines: Split Text (10 headlines) → List Selector (Random 1) → Text Node → Scene → generates a video about a random headline each time.

Top 3 Items: Split Text (full list) → List Selector (First 3) → feeds into 3 parallel Text Nodes for batch processing.

Specific Picks: Split Text → List Selector (Multiple: indices 0, 4, 7) → cherry-picks exactly the items you want.

Tips & Best Practices

Use Random mode for variety — each workflow run picks different items
First N is great for “top stories” or “most recent” patterns
The output separator matters when multiple items are selected — newline works best for most downstream nodes
Range mode is 0-indexed: Range 0-2 gives you the first 3 items
If the list has fewer items than requested, the selector returns what’s available (no error)

Troubleshooting

Empty output

The input list is empty or the index is out of bounds. Check that the Split Text Node is producing items.

Wrong items selected

Indices are 0-based. Index 0 is the first item, index 1 is the second, etc.

Items merged together

Check the output separator. If items appear as one long string, switch to newline separator.