maestro
latest
false
- Introduction and getting started
- Maestro landing page
- Process modeling
- Process implementation
- Process operations
- Process monitoring
- Process optimization
- Licensing
- Reference information
Maestro user guide
Last updated Aug 12, 2025
Use markers to configure the execution of a certain task type to create multiple executions of that task by iterating over a List variable. Visit Markers in the BPMN primer chapter fopr more details.
With any task type selected, select Change element and choose one of the marker types.
The task executes in parallel and waits for all runs to be completed successfully before continuing to execute the rest of
the process.
Note:
- Currently, the parallel multi-instance does not work with subprocesses.
- Currently, the parallel multi-instance executes elements in batches of five.
The task executes each item in the list one by one, waiting for each to be completed successfully before starting the next one. Once all tasks are completed, the rest of the process continues executing.
To handle iteration-like tasks in Maestro (e.g., validating a list of items), you can use Parallel or Sequential markers. Markers behave like traditional loops, but they're more powerful, because they scale better.
These markers let Maestro dynamically fan out one task per item in the list — similar to a traditional
forloop — while preserving scalability and observability.
Example:
You receive a list of invoice IDs from an external API. You need to validate each invoice by calling another API. Instead
of writing a loop, mark the task as multi-instance.
- Use a dynamic list of invoices (from a previous step or external interrogation).
- Define what to send for each iteration of the "loop".
