Troubleshooting Tips for UiPath Developers 🛠️

6 min readOct 14, 2023

UiPath is a tool for developing robotic process automation (RPA) projects. However, like any software, we may encounter technical issues. For someone who encounters a technical issue, it is very important to know how to solve the problems. In this article, I wanted to provide a step-by-step guide to help you overcome technical issues and get your automation project back on track.

1-) Define the Problem

Before proceeding with troubleshooting, it is very important to clearly define the problem you are experiencing. We need to gather clues to understand what the problem is. For this, we should ask questions such as the following:

What exactly is the problem you are facing?
When did the problem start?
Is the problem continuous or intermittent?
Have there been any recent changes in your automation project or environment (computer/server)?
Is there any information about the error in the logs?

2-) Check All Logs

The system logs will give us the most detailed information about the cause of the error. Therefore, we should check all the logs we can get.

To view logs via Orchestrator; (only for production environment errors)

Login to the Orchestrator web app.
Log in to the relevant tenant and folder.
Open Automations ➜ Jobs tab.
Identify the job you got error from the job list.
Click “View logs…” from the 3 dots on the right section.

To view logs via UiPath Studio; (for errors during development)

Open the Output panel, usually at the bottom left.
The panel that opens contains logs. Filtering can be done here.
Alternatively, you can open the Log folder by pressing the CTRL + L key combination while UiPath Studio is open. In this folder, all logs on UiPath Studio from past to present are stored in txt files.

To view Event Logs; (for logs saved in the operating system)

Open the EventViewer application on your computer or server.
Select Windows Logs ➜ Application from the left menu.
Select “Filter Current Log…” from the Actions panel on the right side.

Select the time period and event level from the window that opens.
Among the errors listed, the ones with UiPath in the Source section are the ones we need to check.

If we want, we can save these errors to our computer by selecting the “Save Filtered Log File As…” option from the Actions panel on the right side.

We have done the first step to solve the problem, that is, we tried to understand the error from the error logs. If we understand the error through the log information, we can take action to reach the solution. If we still cannot understand or resolve the error, then we should continue with step 3.

3-) Running the Workflow with Debugging

Sometimes the best way to detect and solve a problem is to run the relevant part in Debug mode. In UiPath Studio there is a Debug menu at the top. Running step-by-step with the functions there helps to breakpoint the source of the problem. You can define breakpoints and examine variables to troubleshoot effectively.

We can use the Locals panel to see the values of variables during debugging. With the help of Locals, Watch and Immediate tabs in the Locals panel, we can see the current values of variables and arguments. If we see a problem with the variable values, we can detect the problem.

4-) Review Potential Environmental Issues

In some cases, the source of the problems may be environment related, i.e. computer/server related. Environment-related problems are usually as follows.

Software Updates: Make sure that UiPath programs, the applications we use in automation and other related software are up to date. The problem you are experiencing may be related to the version of the software you are using.
Access Permissions and Authorizations: If you use various software, shared folders, websites, etc. in your automation, check whether your computer (or server) has permission and authorization to access these resources. The main reason for some errors is that you do not have access permission or authorization.
Network Connectivity: Check if there is a network connection problem in the environment where you run your automation. Internet access failure can also cause you to get an error in UiPath.

5-) Ask UiPath Community for Help

One of the biggest advantages of UiPath is that it has hundreds of thousands of developers around the world. There are thousands of helpful developers on the UiPath Forum.

When you cannot solve your problem yourself, you can search for it on the UiPath Forum. You can use the clues from the log messages as search keywords. It is very likely that someone else has experienced a similar problem. You can find a solution to your bug in the topics in the forum. If there is no topic about your bug, you can start a new one.

In addition to this; if you are already working in an RPA team or if there is an RPA team in your organization, you can consult with the colleagues in that team. They may have experienced the same error before and know the solution.

6-) Read the Documentation

Sometimes the problem we have can be due to a lack of fundamental knowledge. If we don’t know exactly how to use an activity or library package, we may experience errors due to related items. The easiest way to learn how to use an activity or library is through documentation.

You can access UiPath’s documentation at this link. We are lucky because UiPath has a very comprehensive documentations for libraries and activities. Here we can find detailed technical information about the product and its elements. Sometimes this information helps us to solve the problem we are having.

7-) Create UiPath Technical Support Ticket

Note: To perform this step, the UiPath product must be licensed in your organization. Otherwise, you will not be able to create a ticket.

If we have tried all the steps and still cannot find a solution, then we can contact UiPath’s technical support team. UiPath’s technical support team consists of highly experienced international engineers. Therefore, when creating our registration, we must enter all the information in English.

To do this, we need to log in to the Customer Portal from this link with your corporate e-mail address. If you have not logged in before, you can register with your corporate e-mail. After logging into the Customer Portal, we can open the Support tab and create our support request by clicking the Create New Case button. UiPath Technical Support team will provide support to solve your problem in a very short time. Do not forget to check your e-mails at this stage.

The above steps will most likely lead you to a solution. Remember that the problems you experience help you to improve. As the famous engineer Taichi Ohno, inventor of the Toyota production system, said, “Having no problems is the biggest problem of all.”