maestro
latest
false
  • Overview
    • Introduction to UiPath Maestro™
    • Requirements
    • Example scenarios
  • Process modeling
  • BPMN
  • Process implementation
  • Process operations
  • Process monitoring
  • Process optimization
  • Reference information
UiPath logo, featuring letters U and I in white

Maestro user guide

Last updated Jun 23, 2025

Sub-processes and modularity

Sub-processes support model clarity by grouping related activities into a single reusable structure. They help reduce diagram complexity, isolate business logic, and encourage reuse.

In BPMN, a sub-process can be modeled either inline or via a reusable call activity. In Maestro:
  • Only call activities are supported.
  • The sub-process must be modeled as a separate diagram.
  • The calling process passes input and receives output via defined parameters.

Why use call activities?

A call activity references a sub-process defined elsewhere in the project or environment. It behaves like a reusable function. call activities improve process modeling by:

  • Reducing duplication across diagrams
  • Isolating reusable logic (e.g., approvals, validations, dispatching)
  • Keeping the main diagram concise
  • Supporting consistent behavior across process variants.

How to model sub-processes

To create a sub-process in Maestro:
  • Model the sub-process as its own standalone diagram.
  • In the parent diagram, insert a call activity.
  • Link the call activity to the sub-process.
  • Configure input and output variables to exchange data.

Modeling examples

Use case: An onboarding workflow uses the same Collect Documents sub-process in both employee and vendor onboarding processes. Instead of duplicating steps, a call activity is added in each parent process referencing the same sub-process.



Modeling guidelines

  • Give sub-processes meaningful business names (e.g., Verify Contract Terms).
  • Document input/output parameters and their expected usage.
  • Keep sub-processes focused on a single responsibility or outcome.
  • Avoid designing sub-processes with assumptions about the parent context.

Naming conventions

Sub-process and call activity names should:

  • Use business language, not technical terms
  • Describe the outcome (e.g., Collect Customer Data, not Form Step 2)
  • Reflect what the sub-process accomplishes, not how.

Not supported

  • Expanded sub-processes (i.e., inline sub-processes) are not supported. All sub-processes must be modeled as separate diagrams and invoked using Call Activities.
  • Ad-hoc sub-processes are not supported.
  • Implicit variable sharing is not supported. Data must be explicitly mapped through input/output bindings.

Multi-instance markers

Sub-processes support multi-instance markers, where each element is executed multiple times. The elements that can be marked as multi-instance are all task types except for sub-processes.

Nested markers

The following string variables are supported as nested iterators:
CategoryAttributesHow to use/access
OuterSP - Get Contact Information for each user InputCollectionvar.GetUsers
OuterSP - Get Contact Information for each user Iterator Itemiterator.item.gid
InnerSP - Get all emails for each contact InputCollectioniterator[0].item.contactArray
InnerSP - Get all emails for each contact Iterator Itemiterator[1].item.ContactId
Send EmailInputCollectioniterator[1].item.EmailArray
Send EmailIterator Itemiterator[2]item.emailAddress

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

Was this page helpful?

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