# Repeat steps for each item with a loop

> Add a Loop / Bulk Action step to run the same steps once for each record or list item, such as each open job of a customer or each line of a webhook.

Source: https://tadabase.com/docs/workflows/repeat-steps-with-a-loop  
Status: Verified Nov 17, 2026. Checked against the current product

A loop runs the steps inside it once for each record or item in a set. Use it when one run of a workflow has to act on many things, for example to email a customer about each of their open jobs, or to create one record for each line of an incoming webhook.

## Add a loop

1. **Add the step** In the workflow editor, click **Add Step**, then **Loop / Bulk Action**. The canvas shows a **Looper · Bulk Action** card titled **For Each Record**.
2. **Choose what to loop over** In the side panel, under **Records from** (or **Items from** for a list), pick the source. The options are described below.
3. **Narrow the records (optional)** For a table or a one-to-many connection, set **Filters** (only records that match are looped) and a **Sort order**.
4. **Add the steps to repeat** On the canvas, click **Add action inside loop** and add the steps. Each runs once per record or item.
5. **Check the settings** Under **Loop behavior**, check the maximum and what happens on errors or when nothing is found.

![A loop on the workflow canvas that goes through a customer's open jobs, with two steps inside it](https://tadabase.com/docs-shots/workflows-loop-node.webp)

## What a loop can go through

| Group in the list | What it loops over |
| --- | --- |
| **All Tables** | Records of any table, narrowed with Filters and a Sort order. |
| **Connected Data** | Records connected to the workflow's record, such as a customer's jobs. |
| **Step Data** | Records from an earlier [Find Records](https://tadabase.com/docs/workflows/find-records-in-a-workflow), Copy Record, Copy Record and Child Records or Update Connected Records step. |
| **Trigger Array Data** | A list inside the data an **Incoming Webhook**, **Email Catcher** or **External Data Source** trigger received, such as the line items of an order. |
| **Step Array Data** | A list inside an earlier step's response: Run Custom Code, Trigger Pipe, AI Prompt, Export to JSON, [Transform JSON](https://tadabase.com/docs/workflows/reshape-json-with-transform-json) or [Aggregate](https://tadabase.com/docs/workflows/count-and-total-with-aggregate). |

The list groups are only offered when there is something to pick: for example, a list from a step appears once that step has a sample response with a list in it. Click the eye icon next to **Items from** to preview the source data.

## Use the current item inside the loop

Inside the loop, each run works on one record or item, called the current loop item (`currentItem`).

- To read its values, open **Select value source** and choose **Loop Item**. The fields of the workflow's own record stay available under **Source Record**.
- To act on the looped record itself, for example in an **Update Record** step, choose **Loop Item** as the record to update. When the loop goes through a list rather than records, steps that need a Tadabase record cannot use the loop item as their record; use its values instead.
- In a condition inside the loop, pick the field to check under **Loop Item**.

For a list, you can pick a **Unique Key** under **Loop behavior**, such as a customer ID or order number. It lets you see which items finished and which had problems.

## Loop settings

| Setting | Options |
| --- | --- |
| **On iteration error** | **Continue with the next record** (or item), or **Stop the workflow**. |
| **When no records are found** | **Skip the loop and continue**, or **Fail the workflow**. |
| **Maximum records** (or items) | How many the loop processes. The default is 500. A loop over records goes up to 500; a loop over a list goes up to 10,000. |
| **Equations Update** | When Equation fields recalculate for records the loop writes: **Default** (follows the workflow's own setting), **Send Equations to the Queue**, **Run Entire Table Equations** or **Don't run Equations**. Recalculating on every pass is the slowest part of a large loop. |

## Use the results after the loop

Steps after the loop can read its totals under **Step Data**: **Status**, **Total Records**, **Succeeded**, **Failed**, **Skipped**, **Has Failures**, **First Error**, **All Record IDs**, **Processed Record IDs** and **Failed Record IDs**. For example, add a [Condition](https://tadabase.com/docs/workflows/conditions-and-branches) on **Has Failures** to email an admin when something went wrong.

## Turn a loop off

On the loop's **Advanced** tab, turn off **Enabled**. The loop stays in the builder with a **Disabled** badge and Skipped during workflow runs: the loop and every step inside it are skipped, and they do not appear in logs or notifications. The steps inside keep their own enabled setting for when you turn the loop back on. To delete the loop, open its **...** menu and click **Remove Loop**.

## Limits

- A loop cannot go inside another loop. You can add Condition and Branches steps inside a loop.
- A Show Message step inside a loop cannot wait for an answer.
- Loops have no plan limit of their own, but the workflow's own limits, such as its run time, still apply; see [Workflow limits and troubleshooting](https://tadabase.com/docs/workflows/workflow-limits-and-troubleshooting).
