# Troubleshooting

> Solutions for common automation issues in Citrix environments, including restrictions introduced in Citrix Virtual Apps and Desktops 7 2109.

This page explains how to fix issues you might encounter when running [automation in Citrix environments](https://www.uipath.com/platform/agentic-automation/ai-ecosystem/citrix-automation).

## Virtual channels blocked by default

### Observed behavior

After upgrading to a Citrix version higher than [Citrix Virtual Apps and Desktops 7 2109](https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/whats-new.html#citrix-virtual-apps-and-desktops-7-2109), existing Citrix automations that rely on [UiPath Remote Runtime](https://docs.uipath.com/studio/standalone/2026.10/user-guide/about-uipath-remote-runtime#uipath-remote-runtime) fail: selector generation stops working and UI Automation activities can no longer detect Citrix elements.

### Cause

Starting with **Citrix Virtual Apps and Desktops 7 2109**, all custom virtual channels are blocked by default, which prevents **UiPath Remote Runtime** from communicating with the Citrix session.

### Solution

Add the UiPath virtual channel to the Citrix allow list policy:

1. Configure the allow list policy by following the [Citrix virtual channel allow-list policy settings](https://docs.citrix.com/en-us/citrix-virtual-apps-desktops/policies/reference/ica-policy-settings/virtual-channel-allow-list-policy-settings.html) documentation.
2. Add the following value to the allow list policy, replacing `<UiPathRemoteRuntime-Install_Path>` with your install location:

   `UIPCTX,<UiPathRemoteRuntime-Install_Path>\UiPathRemoteRuntime.exe`

   For example:

   `UIPCTX,C:\Program Files (x86)\UiPath\RemoteRuntime\UiPathRemoteRuntime.exe`

## Interactive selection in Citrix apps freezes and nothing is selected

### Observed behavior

After you install the **UiPath Extension for Citrix** and try to select UI elements from a Citrix App, interactive selection freezes for one minute, and then nothing is selected.

### Cause

This happens if the **UiPath Remote Runtime** is not running in the Citrix App session.

### Solution

* Check if the [UiPathRemoteRuntime.msi](https://docs.uipath.com/studio/standalone/2026.10/user-guide/about-uipath-remote-runtime#uipath-remote-runtime) is installed on the Citrix application server from which the Citrix App is opened.
* On the Citrix application server, check if the **UiPathRemoteRuntime.exe** process is running. If the **UiPathRemoteRuntime.msi** is installed, then the process is started automatically on the Citrix App session login.

  ![Solution](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-167865-b5df80e3.webp)

  :::note
  If you cannot install **UiPathRemoteRuntime.msi** on the Citrix application servers, consider uninstalling the **UiPath Extension for Citrix** from the client machine. For instructions, see [Extension for Citrix](https://docs.uipath.com/studio/standalone/2026.10/user-guide/extension-for-citrix#uninstalling-the-extension).
  :::

## Could not copy over file "C:\Program Files (x86)\Citrix\ICA Client\UIPathPluginCitrix.dll". It is being used by another process.

### Observed behavior

When you try to install the [UiPath Extension for Citrix](https://docs.uipath.com/studio/standalone/2026.10/user-guide/extension-for-citrix), the following error is displayed:

  ![Observed behavior](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-168849-d559086a.webp)

### Cause

This occurs when the **UiPath Extension for Citrix** is already installed and an open Citrix App is using it.

### Solution

Close all active Citrix App sessions, as described in [Restarting active Citrix sessions](https://docs.uipath.com/activities/other/latest/ui-automation/configuration-steps-citrix), then reinstall the **UiPath Extension for Citrix**.

## Could not read Citrix registry key: 'SOFTWARECitrixInstallICA Client' Value: 'InstallFolder'

### Observed behavior

When you try to install the **UiPath Extension for Citrix**, the following error is displayed:

  ![Observed behavior](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-166876-9dad3ac1.webp)

### Cause

This error message is displayed when the Citrix Receiver is not installed. It is also displayed if the Citrix Receiver for Universal Windows Platform is installed.

### Solution

Download and install the [Citrix Receiver](https://www.citrix.com/downloads/citrix-receiver/) or [Citrix Workspace](https://www.citrix.com/downloads/workspace-app/).

## Unhandled exception in Wfica32.exe 0xC0000094: Integer division by zero

### Observed behavior

Target Citrix App fails to launch and the Citrix ICA client crashes.

### Cause

Activities which use the **GetWindowText** function (such as **Element Exists**) are executed before the Citrix App can load.

### Solution

Allow time for the Citrix App to load by adding a delay before the activity.

## Interactive selection and element identification does not work with high DPI

### Observed behavior

Starting with Citrix Workspace App (CWA) for Windows 2206, if no High DPI policy settings are applied, interactive selection and element identification might not work for Citrix Apps when the display DPI scaling is higher than 100%.

### Cause

This is caused by the following change in Citrix: DPI support changes with Citrix Workspace App for Windows 2206.

### Solution

Delete the **Enable_DPI** registry value from `Computer\HKEY_CURRENT_USER\SOFTWARE\Citrix\ICA Client\DPI`:

  ![Solution](https://dev-assets.cms.uipath.com/assets/images/studio/studio-docs-image-171704-e9cdad77.webp)
