What is List?

A List is a way to handle multiple pieces of data as "one bundle."

Where Queue "runs the same workflow many times," a List processes multiple inputs one after another in a single run.

  • Queue
    • Runs the same workflow over and over, from the outside
  • List
    • Works through multiple inputs in order, on the inside

It's easiest to think of it as the difference between "pressing Run many times" and "feeding multiple inputs into a single Run."

Creating and Retrieving a List

Create List Node

This node lets you assemble a List manually. It combines values of any type, such as images, text, or numbers, into a single List.

create_list.json
  • Connecting a node adds another slot, so you can include as many items as needed.

Get Item From List Node

Picks out one item from a List by its position.

get_item_from_list.json
  • index: Position to retrieve (0, 1, 2...)

Behavior when there are multiple Lists

image2image_2list_3list.json

For example, take this image2image setup:

  • List of images: 3
  • List of prompts: 2

You might expect "3 x 2 = 6 images," but what actually happens is that the Lists "move forward in step."

  • 1st image x 1st prompt
  • 2nd image x 2nd prompt
  • 3rd image x 2nd prompt is reused

In other words, only 3 images are generated.