Home/HighLevel/Features/Workflows/How to set up and use the Loop action in HighLevel

Workflows and Automation

How to set up and use the Loop action in HighLevel

In short

Loop is a workflow action in HighLevel that repeats a group of actions for each element in a list or for each number in a defined range. It lets businesses process multiple records from a single trigger, map current item data, choose sequential or parallel execution, and inspect results per iteration.

AreaWorkflows · Workflow Actions
Used forHome services business, Ecommerce platform, Event management company
Setup steps24 steps in 4 tasks
Last updatedNovember 17, 2026

01Who this is for

  • Founders of SaaS platforms that receive webhook arrays and need to create separate records per item.
  • Home services agencies that get several service requests in one inbound webhook and must generate individual opportunities, tasks, and notes.
  • Marketing teams that want to run the same email or task creation step for each contact in a list without duplicating workflow steps.

02Loop actions, explained

The Loop action sits inside the HighLevel workflow builder. It takes either a list supplied by a previous step or a numeric range and runs the actions placed inside its dashed box once for each item or number.

Each iteration can use the current item’s fields through Custom values > Loop Item. You decide whether iterations happen one after another (Sequential) or at the same time (Parallel). After all iterations finish, any actions placed after the Loop run a single time.

03How businesses use the Loop action

  • Home services business. After an inbound webhook that contains a services array, the business adds a Loop over the list, maps Loop Item fields to opportunity, task, and note actions, and creates separate records for each requested service.
  • Ecommerce platform. When an order includes multiple line items, the platform loops over the items list, uses Loop Item values to create a fulfillment task for each product, and attaches the appropriate SKU and quantity.
  • Event management company. From a trigger that provides an attendee list, the company loops over the list, maps Loop Item fields to reminder emails, and sends a personalized reminder for every attendee.

04The numbers and rules that matter

  • Start Number: First number in the range. Default: 1. For range loops.
  • End Number: Last number in the range. Default: 10. For range loops.

05Before you start

  • A workflow trigger or earlier action must provide the list or data that the Loop will process.

06How to set up and use the Loop action in HighLevel

Add and configure Loop

  1. Navigate to the subaccount where the workflow will run.
  2. Open Automation > Workflows.
  3. Open an existing workflow or create a new one.
  4. Add a trigger that supplies the list or data to be looped.
  5. Click the + icon at the point you want the Loop to begin.
  6. Search for Loop in the Actions panel and select it.
  7. In the Loop settings, choose A list of items or A range of numbers.
  8. For a list, click the tag icon in Items and select the list field from a previous step.
  9. For a range, enter the Start Number and End Number.
  10. Set the Execution Mode to Sequential or enable Parallel.
  11. Click Save action to place the Loop on the canvas.

Add actions inside the Loop

  1. Click the + icon inside the dashed Loop box.
  2. Add the actions you want to repeat, such as Create Opportunity, Add Task, or Add Note.
  3. To use data from the current item, click the tag icon in an action field and select Custom values > Loop Item.

Review the finished Loop

  1. Confirm that only actions inside the dashed box repeat for each item.
  2. Ensure actions placed below the Loop run once after all iterations finish.
  3. Save the workflow.

Test the Loop

  1. Open the workflow containing the Loop.
  2. Click Test workflow in the upper right corner.
  3. On the New test tab, select Test using events.
  4. Choose the workflow trigger and a recorded event (or enable Listen for events and trigger a new event).
  5. Review the event data and click Start test run.
  6. When the test finishes, select the Loop step on the canvas and open its Test tab.
  7. Use the Iterations list to inspect each iteration’s Input and Output.

07What it looks like in HighLevel

08Settings that matter

  • Action Name. The label shown on the workflow canvas; defaults to Loop.
  • Loop Over. Selects whether the Loop processes a list of items or a numeric range.
  • Items. The list chosen from a prior step, such as an array from an inbound webhook.
  • Start Number. First number in a range loop; defaults to 1.
  • End Number. Last number in a range loop; defaults to 10.
  • Execution Mode. Determines if iterations run sequentially (default) or in parallel.

09Things to know before you rely on it

  • Loop Over is mandatory; you must select either a list or a range.
  • When looping over a range, the default start and end numbers are 1 and 10.
  • Parallel execution is optional and may reduce processing time when actions call external systems.
  • In a range loop, List item fields are empty; use the loop counter under Custom values > Loop Item for the current number.
  • Actions placed after the Loop run only once, after all iterations finish.

10How it connects to the rest of HighLevel

Michael's take

Michael Reimer
Michael ReimerFounder of CRM Pros, HighLevel Commander and Certified Admin

I think the Loop action can reduce the need to build separate workflows for each record. It lets you take a list. Like three service requests from a webhook. And create an opportunity, task, and note for each one by adding the Loop, pointing it at the array, and mapping the fields.

If I were setting this up, I’d start with a simple inbound webhook that returns a list of items. I’d run a quick test with a handful of dummy records, check the Loop’s Test tab, and make sure each iteration creates the right records before I publish the live workflow.

Get More InformationOpens on HighLevelPublished November 3, 2026 · Updated November 17, 2026

Common questions

Common questions about the Loop action.

What is Loop Item?

Loop Item represents the current item being processed; you map its fields using Custom values > Loop Item inside actions placed in the Loop.

How many times will the Loop run?

The Loop runs once for each list item or each number in the defined range; the helper text shows the total iteration count.

What is the difference between Sequential and Parallel?

Sequential processes one iteration at a time, while Parallel runs several iterations at the same time.

Can I use Loop Item with a range of numbers?

Yes. In a range loop, use the loop counter under Custom values > Loop Item; list item fields are empty.

Where can I review each iteration?

After running a workflow test, select the Loop step and open its Test tab to see iteration details and inspect individual action results.

Do actions below the Loop run for every item?

No. Only actions inside the dashed Loop box repeat; actions placed after the Loop execute once after all iterations finish.

Next step

Pick the features that matter. Then get the plan that unlocks them.

Explore the features you want, start with the five at the top, and upgrade through my link when you are ready. The bonuses and the team come with it.

The features directory explains every HighLevel feature in plain English. Browse it to see what the platform can do.

Back to the FeaturesSee the full details
⌃

Site preview

Explore the next page

This destination is reserved in the page inventory and is not built yet.