Skip to main content
Run a set of actions over each item in a list. Use this to process multiple records, URLs, files, or any collection of data — each item goes through the same sequence of actions, and the results are combined at the end.
Loop is an advanced feature. If you need help setting it up for your use case, reach out to our team at support@cassidyai.com.

​
Prerequisites

You need a list variable to loop over. You can get one from:
  • Extract Information with the “List” option checked
  • Trigger inputs with Allow multiple values enabled
  • Run Code actions that output lists
  • Structured outputs from other actions
  • Actions that return multiple records (like CRM lookups)
Or you can enter hardcoded items directly.
1

Add the action

In the Workflow builder, click + between blocks and select Loop from the action library.
Plus button between Workflow blocks
Loop action selected from the action library
Once added, the Loop appears in your Workflow with a dedicated area for inner actions:
Loop action interface in the Workflow builder
2

Select the list to loop over

In List of Items to Loop Over, choose how to provide the list:
  1. Select an existing list variable — Click the field, choose Select a variable, and pick a list variable from a previous step or trigger.
Select a variable option in the list field
Variable selector showing available list variables
List variable selected and displayed
  1. Enter hardcoded items — Click the pencil icon to switch to manual entry. Type an item or click # to reference a variable, then click Add. Repeat for each item.
Manual item entry with hardcoded values and variables
3

Add actions inside the loop

Click + inside the Loop to add actions that run for each item. For each item in the list, these actions run once — so if your list contains 3 items, the Loop runs 3 times.
Adding an action inside the Loop
To pass the current item to an action, select the Current item variable from the Loop section of the variable selector.
Current item variable selected from the Loop section
You can add multiple actions inside the Loop — each item goes through the full sequence.
Multiple actions configured inside the Loop
4

Configure the loop output

Choose how results from each iteration are combined:
Loop Output configuration options
  • Default — Concatenates all outputs from each iteration into a single merged result.
  • Custom Text — Define a template for how each iteration’s output is formatted. Use # to reference variables from the loop’s inner actions.
Custom Text output template with variables
Choose a separator to place between individual loop results when merging: New Line, Dashed Line, or Comma-Separated.
Separator options: New Line, Dashed Line, Comma-Separated
  • Select Specific Variables — Choose which variables to return as lists, with one value per iteration (in order). Useful when you need a clean list of outputs for later steps (e.g., titles, URLs, IDs, or files).
Select Specific Variables output configuration
Selected variables returned as lists
5

Use the loop output

After the Loop, reference its output in subsequent actions. The combined output is available as a single variable.
Action after Loop referencing the Loop output variable
Combine Text action using the Loop output
6

Inspect individual loop iterations

After running the Workflow, click the numbered icon on the Loop step to inspect each iteration. Open any individual loop to see the result and output of each action within that iteration.
Inspecting individual loop iterations in the run results