UiPath Studio

The UiPath Studio Guide

Known Issues and Limitations

With the help of UI Automation activities you can natively generate selectors for Citrix technologies and create your automation projects. There are, however, a few things to consider:

Interactive Selection With High DPI

Interactive selection with High DPI is natively performed in Citrix Apps. Please note that it is mandatory to restart your active Citrix sessions after you change DPI scaling options.

If you are using multiple displays with different DPI scaling options and you move the target window across the displays, UI element selection can appear offset. In this case, it is recommended to resize the target window and select UI elements again.

Upgrading to the Citrix Workspace v1810

After you upgrade the Citrix Receiver to the Citrix Workspace, the UiPath Extension for Citrix is automatically uninstalled. In order to build selectors for Citrix technologies again, you need to reinstall the UiPath Extension for Citrix.

Please note that after upgrading to the Citrix Workspace v1810 the UiPath Extension for Citrix becomes corrupted. This is a known issue with this particular version of Citrix Workspace, and prevents you from opening any Citrix Apps. The following error message is displayed:

You might be having an issue with a Citrix virtual driver (UiPathPluginCitrix). Contact your system administrator for further assistance.

To fix this issue, you need to reinstall the UiPath Extension for Citrix and then restart the Citrix Workspace.


Please note that after every upgrade or installation of the Citrix Receiver or Workspace the UiPath Extension for Citrix needs to be reinstalled.

The Citrix Receiver for Universal Windows Platform (UWP) is Not Supported

The UiPath Extension for Citrix can not be installed for the Citrix Receiver for Universal Windows Platform. This also applies to Citrix Workspace for Universal Windows Platform. In this scenario, it is advisable to install the standard Citrix Receiver or Citrix Workspace instead.

The Citrix App Session May Enter The Idle State During Background Automation

If a Citrix App does not receive any input from the user for a while, the associated Citrix session enters the idle state and disconnects. The idle disconnect timeout value is configured on the Citrix application server, and is generally about 30 minutes.

By default, the Click and Type Into activities send hardware events to the Citrix App, just as a regular user would. This prevents the Citrix App from entering the idle state.

However, if you use only background automation (such as the Click activity with the SendWindowMessages property enabled) for more than 30 minutes, the Citrix App may enter the idle state, and the following message is displayed:


If you run into this issue, it is recommended to increase the idle timeout value on the Citrix application server.

Updated 3 years ago

Known Issues and Limitations

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.