The Loop action in HighLevel Workflows repeats actions for every item in a list or every number in a range. Learn how to configure a Loop, map item data, choose an execution mode, and review results for each iteration.
Table of Contents
- What Is the Loop Action?
- Key Benefits of the Loop Action
- Action Name
- Action Description
- Action Details
- How to Configure
- Behavior and Logic
- Testing the Loop
- Use Case
- Frequently Asked Questions
- Related Articles
What Is the Loop Action?
The Loop action runs a group of workflow actions once for each item in a list or once for each number in a range. Use it to process multiple records from one trigger without duplicating actions or writing code.
For example, a webhook containing three service requests can trigger a Loop that creates a separate opportunity, task, and note for each service.
Key Benefits of the Loop Action
Loop makes it easier to process multiple records within one workflow.
- Process multiple items: Run the same actions for every item received from a previous step.
- Use current-item data: Map fields through Custom values > Loop Item.
- Repeat a fixed number of times: Use a number range instead of a list.
- Choose execution order: Run iterations sequentially or in parallel.
- Review individual results: Inspect each iteration and its actions in the Test tab.
Action Name
The action appears in the workflow builder as Loop.
Action Description
Iterate over a list or a range of numbers and run the actions inside the Loop once for each item or number.
Action Details
These settings control what the Loop processes and how its iterations execute.
| Field | Description | Mandatory |
|---|---|---|
| Action Name | Name displayed on the workflow canvas. Defaults to Loop. | Yes |
| Loop Over | Choose A list of items or A range of numbers. | Yes |
| Items | List selected from a previous step, such as an inbound webhook array. | For list loops |
| Start Number | First number in the range. Default: 1. | For range loops |
| End Number | Last number in the range. Default: 10. | For range loops |
| Execution Mode | Sequential by default. Enable Parallel to run multiple iterations at the same time. | No |
How to Configure
Configure the Loop after a trigger or action that provides the data you want to process.
Step 1: Add the Loop Action
Start in the sub-account where the workflow will run, and place the Loop after the step that provides its input data.
- From Sub-Account View, go to Automation > Workflows.
- Open an existing workflow or create a new one.
- Add and configure the trigger that provides the input data.
- Click the + icon where the Loop should start.
- Search for Loop in the Actions panel and select it.

Click the + icon where the Loop should begin.

Select Loop from the Actions panel.
Step 2: Choose What to Loop Over
Under Loop Over, select one option:
- A list of items: Repeat the actions for each item in a list.
- A range of numbers: Repeat the actions once for each number from Start Number to End Number.
Hover over the information icon beside a field to see its description.

Step 3: Configure the List or Range
The input determines which values the Loop can use. Choose a list from a previous step or define the numbers to repeat.
For a list of items:
- Select A list of items.
- Click the tag icon in Items.
- Open Previous steps.
- Select the trigger or previous action containing the list.
- Choose the list field, such as the services array from an Inbound Webhook Trigger.

Choose a list from a previous workflow step.
For a range of numbers:
- Select A range of numbers.
- Enter the Start Number.
- Enter the End Number.
- Review the helper text showing the total number of iterations.
For example, a range from 1 to 10 runs the actions inside the Loop 10 times.

Configure a number range and review the iteration count.
Step 4: Choose the Execution Mode
Under Execution Mode, choose how the iterations should run:
- Sequential: The default mode. Each iteration finishes before the next begins.
- Parallel: Enable the toggle to run several iterations at the same time.
Parallel execution can reduce processing time when actions depend on external systems.
Step 5: Save the Action
Click Save action. The Loop appears on the canvas with a dashed box for the actions that will repeat.
Step 6: Add Actions Inside the Loop
Click the + icon inside the dashed box and add the actions you want to repeat.
To use data from the current list item, click the tag icon in an action field and select Custom values > Loop Item. Choose a field such as Name, Estimated Value, Urgency, or Preferred Date.
These values change with each iteration.

Select the current item's fields through Custom values > Loop Item.
Note: The opportunity screenshots below show the older Create or update opportunity action. For new workflows, use Create Opportunity. The screenshots demonstrate how Loop Item values are mapped.

Opportunity Name and Opportunity Value mapped from the current item in the original example.

Map Loop Item fields to a task.

Use Loop Item values in a note.
Step 7: Review the Finished Loop
Only actions inside the dashed box repeat for each item. Actions placed below the box run once after the Loop finishes.

The original example shows three actions inside the Loop.
Confirm that each action is positioned correctly. Save your workflow and test it before publishing.
Behavior and Logic
Loop behavior depends on the input type, execution mode, and position of actions on the workflow canvas.
| Rule | What Happens |
|---|---|
| Number of iterations | One iteration per list item or number in the selected range. |
| Sequential mode | Each iteration finishes before the next starts. |
| Parallel mode | Several iterations run at the same time. |
| Loop Item in a list loop | Contains the current item's fields. The values change with each iteration. |
| Loop Item in a range loop | List-item fields are empty. Use the loop counter under Custom values > Loop Item for the current number. |
| Actions after the Loop | Run once, after all iterations finish. |
Testing the Loop
Run a workflow test to verify the input data, number of iterations, and results of the actions inside the Loop.
Run a Workflow Test
Use an event with representative data to confirm that the Loop processes the expected number of items and repeats only the intended actions.
- Open the workflow containing the Loop.
- Click Test workflow in the upper-right corner.
- On the New test tab, select Test using events.
- Under Select Trigger, choose the workflow trigger.
- Under Select event, choose a recorded event. If needed, enable Listen for events and trigger a new event.
- Review the event data and click Start test run.
- When the test finishes, select the Loop step on the canvas.
- Open its Test tab to review the results.
Important: Workflow tests execute real actions. Use test data to avoid unintended messages or changes to customer records.

Test workflow with an Inbound Webhook event.
Review Each Iteration
The Loop's Test tab provides the following information:
- Input: Action Name, Items, Mode, and Loop Over values.
- Output: Items, Succeeded, Failed, and Duration for the Loop.
- Iterations: Each iteration, its status, and the actions executed inside it.
Use the arrows to move between iterations. Click the open icon beside an action to inspect its Input and Output for that iteration.

Review the results and actions for individual Loop iterations.

Example output: 3 items, 3 succeeded, and 0 failed.

Inspect an action's Input and Output for a specific iteration. This screenshot uses the older opportunity action.
After confirming the results, save and publish the workflow when you are ready to activate it.
Use Case
A home services business receives an inbound webhook containing contact details and three requested services: Roof repair, Gutter cleaning, and Exterior painting. It wants to create a separate opportunity, task, and note for each service.
- Inbound Webhook: Receive the contact details and services list.
- Create contact: Map First Name, Email, and Phone from the webhook data.
- Loop: Select A list of items and choose the services array from the Inbound Webhook Trigger.
- Create Opportunity: Inside the Loop, select a pipeline and stage. Map Opportunity Name to Loop Item > Name and Opportunity Value to Loop Item > Estimated Value. Enable Duplicate Opportunity when separate opportunities are needed for the same contact.
- Add task: Map Loop Item > Name to the task title, the relevant service details to the description, and Loop Item > Preferred Date to the due date.
- Add notes: Map Loop Item > Name and Loop Item > Urgency into the note fields.
- Result: The Loop processes all three services. With duplicate opportunity creation enabled and the applicable account settings configured, it can create three opportunities, three tasks, and three notes.
Note: If multiple opportunities are needed for the same contact in the same pipeline, enable Allow Multiple Opportunities per Contact under Sub-Account Settings > Objects > Opportunities.
Frequently Asked Questions
Q: What is Loop Item?
Loop Item represents the current item being processed. Use Custom values > Loop Item to map its fields into actions inside the Loop.
Q: How many times will the Loop run?
Once for each list item or each number in the selected range. The number-range helper text displays the iteration count.
Q: What is the difference between Sequential and Parallel?
Sequential processes one iteration at a time. Parallel runs several iterations concurrently.
Q: Can I use Loop Item with a range of numbers?
Yes. Use the loop counter under Custom values > Loop Item. List-item fields are empty for range loops.
Q: Where can I review each iteration?
After a workflow test, select the Loop step and open its Test tab. Use the Iterations list and open icon to inspect individual action results.
Q: Where do list items come from?
From a previous workflow step that provides a list, such as an Inbound Webhook Trigger. Select the list through the tag icon in the Items field.
Q: Do actions below the Loop run for every item?
No. Only actions inside the dashed Loop box repeat. Actions below it run once after the Loop finishes.
Related Articles
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article