UiPath Documentation
studio
2021.10
false
  • Release Notes
    • 2021.10.3
    • 2021.10.4
    • 2021.10.5
    • 2021.10.6
    • 2021.10.7
    • 2021.10.8
    • 2021.10.9
    • 2021.10.10
  • Getting Started
    • Introduction
    • About Backward and Forward Compatibility
    • The User Interface
    • Keyboard Shortcuts
    • Signing in to Your Account
    • Configuring Studio Settings
    • Project Templates
      • Orchestration Process
      • Background Process
      • Robotic Enterprise Framework
      • Transactional Process
      • Trigger Based Attended Automation
    • Creating a Basic Process
    • Creating a Basic Library
    • Tutorials
  • Setup and Configuration
    • Hardware and Software Requirements
    • Install Studio
      • Deployment guidelines
      • Services Studio Connects To
      • Common Installation Errors
      • Modify or Uninstall Studio
    • Activate Studio
      • About Licensing
    • Update Studio
    • Command Line Parameters
    • Supported Applications and Technologies
    • Enabling Gmail for Email Activities
    • Opting Out of Telemetry
  • Automation Projects
    • About Automation Projects
    • About Publishing Automation Projects
    • About Libraries
      • Loading Web Services in Libraries
      • Activities Generated from Web Services
    • Managing activity packages
    • Configuring Activity Project Settings
    • Signing Packages
    • Governance
    • Importing Entities
    • Modern Design Experience
    • Linking a Project to an Idea in Automation Hub
  • Dependencies
    • About Dependencies
    • Managing Dependencies
    • Project Dependencies Mass Update
      • Mass Update Command Line Parameters
    • Missing or Invalid Activities
  • Types of Workflows
    • Sequences
    • Flowcharts
    • State Machines
    • Global Exception Handler
  • File Comparison
    • About File Comparison
    • Comparing Files
  • Automation Best Practices
    • Workflow Design
    • UI Automation
    • Project Organization
    • Automation Lifecycle
  • Source Control Integration
    • About Version Control
    • Managing Projects With GIT
    • Managing Projects With TFS
    • Managing Projects With SVN
    • Workflow Diff
  • Debugging
    • About Debugging
      • Test Activities
      • Debugging Actions
      • The Locals Panel
      • The Call Stack Panel
      • The Breakpoints Panel
      • The Watch Panel
      • The Immediate Panel
      • Remote Debugging
  • The Diagnostic Tool
    • About The Diagnostic Tool
  • Workflow Analyzer
    • About Workflow Analyzer
    • Naming Rules
      • ST-NMG-001 - Variables Naming Convention
      • ST-NMG-002 - Arguments Naming Convention
      • ST-NMG-004 - Display Name Duplication
      • ST-NMG-005 - Variable Overrides Variable
      • ST-NMG-006 - Variable Overrides Argument
      • ST-NMG-008 - Variable Length Exceeded
      • ST-NMG-009 - Prefix Datatable Variables
      • ST-NMG-011 - Prefix Datatable Arguments
      • ST-NMG-012 - Argument Default Values
      • ST-NMG-016 - Argument Length Exceeded
    • Design Best Practices
      • ST-DBP-002 - High Arguments Count
      • ST-DBP-003 - Empty Catch Block
      • ST-DBP-007 - Multiple Flowchart Layers
      • ST-DBP-020 - Undefined Output Properties
      • ST-DBP-023 - Empty Workflow
      • ST-DBP-024 - Persistence Activity Check
      • ST-DBP-025 - Variables Serialization Prerequisite
      • ST-DBP-026 - Delay Activity Usage
      • ST-DBP-027 - Persistence Best Practice
      • ST-DBP-028 - Arguments Serialization Prerequisite
    • Project Anatomy Rules
      • ST-ANA-003 - Project Workflow Count
      • ST-ANA-005 - Check Project.json Exists
      • ST-ANA-006 - Main Workflow Exists
      • ST-ANA-009 - File Activities Stats
    • Maintainability and Readability Rules
      • ST-MRD-002 - Activity Name Defaults
      • ST-MRD-004 - Unreachable Activities
      • ST-MRD-005 - Redundant Sequences
      • ST-MRD-007 - Nested If Clauses
      • ST-MRD-008 - Empty Sequence
      • ST-MRD-009 - Deeply Nested Activities
      • ST-MRD-011 - Write Line Usage
      • ST-MRD-017 - Incomplete If
    • Usage Rules
      • ST-USG-005 - Hardcoded Activity Arguments
      • ST-USG-009 - Unused Variables
      • ST-USG-010 - Unused Dependencies
      • ST-USG-014 - Package Restrictions
      • ST-USG-020 - Minimum Log Messages
      • ST-USG-024 - Unused Saved for Later
      • ST-USG-025 - Saved Value Misuse
      • ST-USG-026 - Activity Restrictions
      • ST-USG-027 - Required Packages
      • ST-USG-028 - Restrict Invoke File Templates
    • Performance and Reusability Rules
      • ST-PRR-004 - Hardcoded Delay Activity
    • Reliability Rules
      • ST-REL-006 - Infinite Loop
    • Security Rules
      • ST-SEC-007 - SecureString Argument Usage
      • ST-SEC-008 - SecureString Variable Usage
      • ST-SEC-009 - SecureString Misusage
  • Variables
    • Managing Variables
    • The Variables Panel
    • Types of Variables
      • Text Variables
        • Example of Using a Text Variable
      • True or False Variables
        • Example of Using a True or False Variable
      • Number Variables
        • Example of Using a Number Variable
      • Array Variables
        • Example of Using an Array Variable
      • Date and Time Variables
        • Example of Using a Date and Time Variable
      • Data Table Variables
        • Example of Using DataTable Variables
    • UiPath Proprietary Variables
  • Arguments
    • Managing Arguments
    • The Arguments Panel
    • Using Arguments
  • Imported Namespaces
    • About Imported Namespaces
    • Managing Namespaces
  • Control Flow
    • About Control Flow
    • Control Flow Activities
      • The Assign Activity
      • The Delay Activity
        • Example of Using the Delay Activity
      • The Do While Activity
        • Example of Using a Do While Activity
      • The If Activity
        • Example of Using an If Activity
      • The Switch Activity
        • Example of Using a Switch Activity
      • The While Activity
        • Example of Using a While Activity
      • The For Each Activity
        • Example of Using a For Each Activity
      • The Break Activity
        • Example of Using a Break Activity
  • Object Repository
    • About Object Repository
    • Creating an Object Repository
    • Reusing Objects and UI Libraries
  • Logging
    • Studio Logs
    • Setup Logs
    • OCR Diagnostic Logs
    • Logging Levels
    • Types of Logs
    • Protecting Sensitive Information
  • The ScreenScrapeJavaSupport Tool
    • About the ScreenScrapeJavaSupport Tool
    • Argument Descriptions for the ScreenScrapeJavaSupport Tool
  • Studio testing
    • Introduction
    • Application Testing
      • Execution Templates
    • Testing project templates
      • SAP Testing Project
    • Test Cases
    • Data-Driven Testing
    • RPA Testing
    • Test Case Templates
    • Test Explorer
      • Test Results
      • Activity Coverage
    • Mock Testing
    • API Test Automation
  • Extensions
    • About extensions
    • SetupExtensions Tool
    • UiPath Remote Runtime
    • Extension for Chrome
      • Group Policies
      • Troubleshooting
    • Extension for Edge
      • Group Policies
      • Troubleshooting
    • Extension for Firefox
      • Troubleshooting
    • Extension for Java
      • Troubleshooting
    • Extension for Silverlight
    • Extension for Citrix
      • Troubleshooting
    • Extension for Microsoft Remote Desktop and Apps
      • Troubleshooting
    • Extension for VMware Horizon
    • SAP Solution Manager Plugin
    • Excel Add-in
  • Troubleshooting
    • About Troubleshooting
    • Microsoft App-V Support and Limitations
    • Internet Explorer X64 Troubleshooting
    • Microsoft Office Issues
    • Identifying UI Elements in PDF With Accessibility Options
    • Identifying UI Elements After Windows Updates
      • Solutions
    • JxBrowser Applications Troubleshooting
    • User Events Monitoring
    • Citrix Troubleshooting
UiPath logo, featuring letters U and I in white
OUT OF SUPPORT

Studio User Guide

Last updated Oct 23, 2025

The Breakpoints Panel

Breakpoints are used to purposely pause the debugging process on an activity which may trigger execution issues. Setting a condition and/or hit count turns the simple breakpoint to a conditional one. Adding logging results turns the conditional breakpoint in a conditional tracepoint. Adding only a logging message transforms the breakpoint to a simple tracepoint.

You can place and modify a breakpoint on any activity as follows:

  • from the context menu, right-click an activity and select Toggle Breakpoint;
  • by selecting the activity, and clicking the Breakpoints button on the Debug tab;
  • by pressing F9 while the desired activity is selected.

A single activity needs to be selected for a breakpoint to be toggled. You can, however, toggle as many breakpoints as you see fit. Make sure that the order of activities in the workflow is not changed after the breakpoint is set.

Each breakpoint or tracepoint receives a specific icon based on its state. The icon is set on the activity and visible in the Breakpoints panel.



Type

Description

Breakpoints

Breakpoints pause the debugging process before the activity is executed. Breakpoints can have the following states:

  • Enabled -
  • Disabled -

Conditional Breakpoints

Conditional breakpoints are breakpoints that depend on a set condition and/or a hit count. Conditional breakpoints can have the following states:

  • Enabled -
  • Disabled -

Tracepoints

Tracepoints are breakpoints with set logged messages. When the tracepoint is reached during debugging, the message is logged at trace level. Tracepoints can have the following states:

  • Enabled -
  • Disabled -

Conditional Tracepoints

Conditional tracepoints have a set condition or hit count, and a logged message. The message is logged when the condition is met the number of times stated in the hit count field. Conditional tracepoints can have the following states:

  • Enabled -
  • Disabled -

To modify the state of a breakpoint or tracepoint select the activity and press F9, click the icon in the Breakpoints panel, or use the Designer or Breakpoints panel context menus. You can also click the Breakpoints button on the Debug tab, open the drop-down menu and click Toggle Breakpoint.

Note: Breakpoints set during design time persist when reopening the automation project. Breakpoints don't persist at runtime, only at debugging.

Select a breakpoint in the panel and click the Delete button to remove it. The Delete all breakpoints option enables you to delete all the breakpoints in the current project. The Enable all breakpoints option helps you enable all breakpoints in the currently opened project. Consequently, the Disable all breakpoints option disables all breakpoints. Multiple selection is available in the Breakpoints panel.

Breakpoint Settings

The Breakpoints panel comes with a set of settings that can be individually adjusted for each toggled breakpoint part of the automation project. Click the icon to open the window.



Note: Please take into consideration that any expression added in the Condition field is not validated.

Field Descriptions for Breakpoint Settings

The Breakpoint Settings window has the following options:

Option

Description

Condition

The condition for the breakpoint. If the condition is met during debugging, the execution breaks and the activity is highlighted.

Hit Count

Specifies the number of times the condition must be met before the execution breaks. If the hit count is higher than the number of times the condition can be met, the execution does not stop upon encountering the breakpoint. The maximum hit count value is 32,767.

Log Message

Specifies the message to be logged at trace level when the condition is met. The message is visible in the Output panel. If a condition is not set, the message is still logged.

Continue execution when logging

If selected, the execution is not paused when the condition is met and the specified message is logged. Available only if a log message was previously set.

Settings for any breakpoint in the project are visible upon hovering the breakpoint in the Designer panel.

The Breakpoints Panel



The Breakpoints panel displays all breakpoints in the current project, together with the file in which they are contained. The Activity Name column shows the activity with the toggled breakpoint, while the File Path column displays the file and its location.

The Condition column displays conditions set to breakpoints. The Log Message column shows messages to be logged if the condition is met. Hover over the breakpoint tag on an activity to view its condition and log message.

Double-click on a breakpoint to see the activity highlighted in the Designer panel. Use context menu options or the Breakpoints button in the ribbon to enable or disable breakpoints.

To delete multiple breakpoints, select them and click Delete in the context menu, or the Delete button in the panel. This removes the breakpoints from the current file.

The Delete all, Enable all and Disable all breakpoints buttons perform actions on all breakpoints listed in the panel, regardless if they are selected or not.

Context Menu for Breakpoints

Right-click an item in the Breakpoints panel to open the context menu with the following options:

Option

Description

Delete

Deletes the selected breakpoints.

Focus

Jumps to the breakpoint in the Designer panel.

Enable

Enables the selected breakpoints.

Disable

Disables the selected breakpoints.

Settings

Opens the Breakpoint Settings window for adding a condition to the breakpoint.

Note: Breakpoint conditions are not evaluated when using Validate File or Validate Project.

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated