ByteChef LogoByteChef

Loop

Loops sequentially over list of items.

Type: loop/v1


Properties

NameLabelTypeDescriptionRequired
itemsList of itemsARRAY
Items []
List of items to iterate over.false
loopForeverLoop ForeverBOOLEAN
Options true, true
Should loop iterate until condition set by 'Loop Break' statement is met.false

Additional Instructions

Loop and Loop Break are two halves of one mechanism, and this section covers both. Loop repeats a set of actions — either once for each item in a list, or continuously; Loop Break is the statement that ends a continuous loop from inside its body.

Using Loop

Step 1: Add Loop to your workflow

Select Loop from the Flows component panel and add it where execution should repeat.

Step 2: Choose the loop mode

Iterate over a list — leave Loop Forever off, and set List of Items to the collection to walk. The value normally comes from a data pill produced by an earlier step:

${googleSheets_1.rows}
${salesforce_1.accounts}
${webhook_1.orders}

The loop ends on its own when the list is exhausted.

Loop forever — switch Loop Forever on. No list is needed; the loop runs until a Loop Break inside its body ends it.

Step 3: Add the loop body

Click + inside the loop to add the components that should run on every pass. When iterating over a list, the current element is available as ${item}, and its fields as ${item.email}, ${item.status}, and so on.

Using Loop Break

Loop Break takes no properties. Add it inside a loop body, normally on a branch of a Condition, and reaching it ends the enclosing loop immediately — the rest of the current pass does not run.

Loop Forever needs a reachable break. With Loop Forever on and no Loop Break that can actually fire, the loop never terminates; it consumes resources until the run hits its execution timeout. Confirm the body contains a break condition that will be met before enabling it.

How is this guide?

Last updated on

On this page