Map step

Map step that iterates over an array from trigger data or previous steps and executes a sequence of sub-steps for each element.

A map step loops over an array and executes a set of steps for each element.

Configuration

Field	Type	Description
source	string	Template expression pointing to the array (e.g., {{payload.line_items}})
steps	array	Steps to execute for each item
maxItems	integer	Maximum items to process. Default: 100, max: 1000.

Within the loop body, access the current item with {{iteration.item}}:

{{iteration.item.product_name}}
{{iteration.item.quantity}}
{{iteration.item.unit_price}}

Example

Process each line item in an order:

{
  "id": "process-items",
  "type": "map",
  "source": "{{payload.line_items}}",
  "maxItems": 50,
  "steps": [
    {
      "id": "check-stock",
      "type": "action",
      "action": "colossal/check_inventory",
      "parameters": {
        "product_id": "{{iteration.item.product_id}}"
      }
    }
  ],
  "next": "after-processing"
}

Next steps

• Parallel step. Run fixed branches concurrently instead of iterating
• Colossal app actions. Available actions to use within map iterations