For the complete documentation index, see llms.txt. This page is also available as Markdown.

Process multiple records with iterators

In this section you will learn about Iterators

An iterator runs its nested steps for each item in a collection or array. Use it to process several tickets with the same action.

Choose the input mode

Mode
Use it when
Configure

Load Data

The iterator should query a connected collection

Resource, collection, and filters

Specify Iterate

A previous step or parameter already contains the items

The array to iterate

Iterator settings

A filtered collection and a user's explicitly selected records are different inputs. For selection-based processing, see Process selected records.

Add the iterator

  1. Open the component workflow, or open Automation and add an automation.

  2. Configure the trigger.

  3. Add an iterator and select its input mode.

  4. Add the repeated actions inside it. You can also move existing steps into the iterator.

  5. Bind each action to the current item's fields.

spinner

For a ticket update, use the current item's ID. Binding every iteration to a single trigger ID would repeatedly target the same ticket.

Example: process a filtered collection

The existing walkthrough uses customers filtered by city. Apply the same pattern to Tickets filtered by priority or status.

A table with customers, multiple-select filter and button with a workflow action
  1. Display records in a table and configure the filter component.

  2. Pass the filter value into a workflow parameter.

  3. Choose Load Data and configure the same filter for the iterator's collection query.

  4. Add a temporary in-app notification to inspect the current item in a component workflow.

  5. After checking the selected scope, configure the intended action.

spinner
spinner

The iterator's query must include the filter; do not assume it automatically inherits a table component's filter.

Test before processing the full list

Start with two fictional records and confirm each is processed once. Test an empty array or a filter returning no rows. Inspect the current item binding and final records. The existing email walkthrough should be tested only with recipients you control.

For actions that can be repeated or partially fail, see failure handling and duplicate processing.

Last updated

Was this helpful?