> For the complete documentation index, see [llms.txt](https://help.imagine.art/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.imagine.art/workflows/text-nodes/text-iterator.md).

# Text Iterator

### Summary

The Text Iterator Node lets you feed multiple text inputs into a workflow and process each one individually through the connected downstream nodes. Enter multiple prompts, descriptions, or any text content — and the iterator passes each one separately to the next node in the chain. It's essential for workflows where you need to generate multiple outputs from different text inputs in a single run.

***

### How to Use

1. Add the Node:
   * Click the Add (+) button and select Text Iterator from the Text node category.
2. Enter Your Text Inputs:
   * Type your content into the available input fields (Input 1, Input 2, Input 3, etc.). Click + Add Another Input to add more.
3. Connect Downstream Nodes:
   * Link the iterator's output to any node you want to apply to each text input — such as Generate Image, Generate Video, or AI Copilot.
4. Run:
   * When the workflow runs, the iterator feeds each text input one by one through the connected nodes, generating a separate output for every input.

***

### Sample Use Cases

<details open>

<summary>Batch Image Generation from Multiple Prompts</summary>

Enter a series of different scene descriptions and connect to a Generate Image node. Each prompt produces its own image — perfect for generating a full set of visuals in one run.

</details>

<details open>

<summary>Multi-Scene Video Production</summary>

Write individual scene descriptions as separate inputs and connect to a Generate Video node. Each text input generates its own video clip, ready to be combined downstream.

</details>

<details open>

<summary>Bulk Ad Copy Variations</summary>

Enter multiple ad copy variations and connect to an AI Copilot node to refine, expand, or translate each one — all in a single workflow run.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.imagine.art/workflows/text-nodes/text-iterator.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
