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

Maestro user guide

Last updated Sep 3, 2025

Simulate

Simulation in Maestro lets you preview how a process will behave—without executing it in production. You can validate control flow, inspect variable changes, and identify design flaws early, before connecting to robots or external agents.

You can simulate both:

  • Control flow: sequences, conditions, and gateways
  • Data flow: inputs, outputs, and variable propagation

This makes it easier to understand the end-to-end behavior of your process during design.

When to use simulation

Use simulation to:

  • Preview how a process behaves before implementation
  • Validate logic early in the design phase
  • Explore conditional flows and gateway outcomes
  • Test data movement without requiring robots or agents

Simulation is especially useful during iterative design or when working with large, modular processes.

How simulation works

Simulation does not run the actual tasks (such as robot jobs, API calls, or agent actions). Instead, it:

  • Evaluates sequence flows.
  • Lets you choose which outgoing path to follow at gateways.
  • Highlights the simulated path directly on the canvas.
  • Displays current variable values in the right panel.
  • Lets you pause and resume execution at any step.

You can inspect the simulation trace and data values at each step to confirm expected behavior.

Running a simulation

To simulate your process in Studio Web:

  1. Select a Maestro process inside your solution.
  2. Right-click on a Start element in the process and choose Simulate.
  3. Select Start Simulation. The simulation begins immediately from that Start event.


The process will simulate visually—each path will be highlighted based on logic execution. The execution trail shows the status and the corresponding step, as well as the detected incidents.

During the run you can:
  1. Switch gateway paths: when reaching a gateway, choose the outgoing branch to follow.

  2. Pause execution: right-click an element and select Add pause. The simulation will stop when it reaches that element. You can also hover over the canvas and click the pause icon when it appears to add pause in that particular place.

  3. Resume execution: right-click the paused element and select Remove pause to continue. You can also hover over the canvas and click the pause icon when it appears to remove pause in that particular place.

Simulation tips

Table 1.
TipDescription
Observe gateway logicYou select which branch to follow. This helps verify the modeled alternatives.
Review parallel/multi-instance behaviorYou can visualize parallel paths or iterations with lists.
Test incomplete modelsSimulation runs even if tasks are not fully configured, allowing safe iteration.

Limitations

  • Simulation does not invoke robots, agents, or integrations.
  • Gateway conditions are not auto-evaluated—you must choose the branch.
  • Use Test mode for live execution when you need to validate actual integrations and system connections.

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.