maestro
latest
false
UiPath logo, featuring letters U and I in white

Maestro user guide

Last updated Oct 30, 2025

Markers

Markers annotate BPMN tasks and call activities to convey intent, such as repetition or compensation. In Maestro, markers are for modeling clarity, except multi‑instance, which Maestro interprets at runtime.

Multi-instance markers

Use a multi‑instance marker when an activity should run once per item in a collection (list or array).
TypeWhat it meansRuntime note
SequentialOne item at a time, in order.Preserves order; next item starts after the previous finishes
ParallelMany items at once.Items run concurrently. Order is not guaranteed.
Important: The task or call activity annotated with a multi‑instance marker must reference a collection (a variable or an expression that evaluates to a list). If the activity returns a result per item and you need a single combined output, configure Aggregation to combine those results (for example, collect as a list or reduce with an expression).




Parallel multi-instance

The task executes in parallel and waits for all runs to be completed successfully before continuing to execute the rest of the process.



Sequential multi-instance

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.



Compensation marker

Marks an activity as eligible for compensation (undo logic) in the diagram. Maestro does not execute compensation automatically at runtime. Implement any undo logic explicitly in your model.

Modeling guidance

  • Use markers to clarify design intent, especially for stakeholders who are not aware of execution constraints.
  • Only the multi‑instance marker changes runtime behavior in Maestro; other markers are visualization aids.
  • Document the loop logic and any compensation approach elsewhere in the process model.
  • Prefer named collections and clear item schemas to improve readability.

Read Multi‑instance implementation for how to configure and run multi‑instance work.

For more details about the BPMN elements supported in Maestro, read BPMN support.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo
Trust and Security
© 2005-2025 UiPath. All rights reserved.