USB device redirection

The generic USB redirection feature allows redirection of arbitrary USB devices from client machines to Citrix Virtual Apps and Desktops. With this feature, the client devices can interact with a wide selection of generic USB devices in a session.

The USB redirection policy must be set to Allowed on the Controller. For information about configuring USB redirection in Citrix Studio, see Configure generic USB redirection.


For printers and scanners:

Ensure that you install the vendor-specific drivers on the device. When the driver installation is complete, the vendor software might ask you to reconnect the USB device. In this scenario, connect the USB device to the local device to redirect it.

For Chromebooks:

By default, USB devices (for example, pen drives) are blocked by the Chrome operating system. You must whitelist the devices using the Google admin console for managed Chromebooks.

For information on how to whitelist USB devices in Chromebook,see Knowledge Center article CTX200825.


Depending on the redirected USB device and the network latency, it might take some time for the device to be visible in Windows Explorer.

Configuring USB redirection on mobiles phones, tablets, and Samsung DeX

  1. Add a USB redirection policy-enabled store and launch a session.
  2. Click the session toolbar icon as displayed in the dialog below:

    session toolbar on Mobile phones

  3. Click the USB Icon in the session toolbar.
  4. Connected USB devices are listed in the USB devices window as shown below:

    Toggle screen

  5. To redirect a particular USB device, click the Toggle option against the device.

    A Workspace permission dialog appears.

    Permission screen

  6. Click OK to grant permission for Workspace app to redirect the device.


    This step is mandatory to redirect the USB device.

    The USB device is redirected and the status is displayed as shown below:

    USB status

Configuring the USB redirection feature on Chromebooks

  1. Add a USB redirection policy-enabled store and launch a session.
  2. Click OK to grant permission for Workspace app to redirect the device.


    This is a mandatory step that appears only after a fresh install.

    USB status

  3. Connect the USB device.
  4. Click the toolbar icon and then the USB icon on the session toolbar.

    Toolbar Chrome

    Connected USB devices are listed as shown below:



    If a connected USB device is not listed, ensure that you have whitelisted it.

    For information on how to whitelist USB devices on Chromebook,see Knowledge Center article CTX200825.

  5. To redirect the USB device, click the Toggle option against the device to be redirected.
  6. Click OK to grant permission for Workspace app to redirect the device.


    The USB device is redirected and the status is updated. Dismiss the dialog to continue using the redirected USB device.


  • If a pen drive is redirected, it appears as listed in a session.
  • If a printer or scanner is redirected, it is displayed in the Devices section in the control panel.

Tested USB devices

Device Manufacturer Model
Printer HP LaserJet P2014
Scanner HP Scanjet G3010
Scanner Canon CanoScan LiDE 700F
Space Navigator 3Dconnexion  
Printer Brother QL-580N
Scanner HP Scanjet 200

Known issues:

  • Only one USB device is supported at a time.
  • Audio and video USB devices are not currently supported.

Citrix Casting

Citrix Casting combines digital and physical environments to deliver apps and data within a secure smart space. The complete system connects devices (or things), like mobile apps and sensors, to create an intelligent and responsive environment.

Citrix Ready workspace hub is built on the Raspberry Pi 3 platform. The device running Citrix Workspace app connects to the Citrix Ready workspace hub and casts the apps or desktops on a larger display.

Using Citrix Casting, you can:

  • Roam your session without launching a VDA session on the mobile devices.
  • View the list of available workspace hubs by tapping View hub list from the Workspace hub dialog.

Configure Citrix Casting

Citrix Casting is enabled when all the following system requirements are met:

  • Citrix Workspace app 1809 for Android or later installed
  • Bluetooth enabled
  • Location enabled
  • Mobile device and workspace hub using the same Wi-Fi network

To turn on the Citrix Casting feature, tap Settings and Citrix Casting on your device.

Known Limitation

  • Web Interface does not support session roaming. Therefore, do not select the Add account type as Web Interface option.

For more information about the Citrix Ready workspace hub in Citrix Workspace app for Android, see Configure the Citrix Ready workspace hub.

For information about the Citrix Ready workspace hub, see Citrix Ready workspace hub documentation.

Content Collaboration Service integration

This release introduces integration of Citrix Content Collaboration Service with Citrix Workspace app. Citrix Content Collaboration enables you to easily and securely exchange documents, send large documents by email, securely handle document transfers to third parties, and access a collaboration space. Citrix Content Collaboration provides many ways to work, including a web-based interface, mobile clients, desktop apps, and integration with Microsoft Outlook and Gmail.

You can access Citrix Content Collaboration functionality from the Citrix Workspace app using the Files tab displayed within Citrix Workspace app. You can view the Files tab only if Content Collaboration Service is enabled in the Workspace configuration in the Citrix Cloud console.


Citrix Content Collaboration integration in Citrix Workspace app is not supported on Windows Server 2012 and Windows Server 2016 due to a security option set in the operating system.


  • Resetting Citrix Workspace app does not cause Citrix Content Collaboration to log off.
  • Switching stores in Citrix Workspace app does not cause Citrix Content Collaboration to log off.

The following image displays example contents of the Files tab of the new Citrix Workspace app:


Keyboard layout synchronization

Citrix Workspace app for Android offers separate options to enable the client IME and keyboard layout synchronization under Settings.

The Enable client IME option allows you to type the double-byte characters (such as Chinese, Japanese, and Korean characters) directly at the insertion point in a session.

The Sync Keyboard option allows automatic keyboard layout synchronization between the VDA and the client device.

On a fresh install and by default, the Enable client IME option is set to On for Japanese, Chinese, and Korean languages and the Sync Keyboard option is set to Off.

To enable dynamic keyboard layout synchronization, set both the Enable client IME and Sync Keyboard options to On.


  • The VDA must be version 7.16 or later.
  • Administrators must enable the enhanced support for Asian languages feature on the VDA. By default, the feature is enabled. However, on Windows Server 2016 VDA, you must add a new key called DisableKeyboardSync and set the value to 0 in HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA\IcaIme to enable the feature.
  • Administrators must enable the unicode keyboard layout mapping feature on the VDA. By default, the feature is disabled. To enable it, create the CtxKlMap key under HKEY_LOCAL_MACHINE\SOFTWARE\Citrix and set DWORD value EnableKlMap = 1 under HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\CtxKlMap.


  • This feature works only on soft keyboards on the devices, not on external keyboards.
  • Certain mobile devices might not fully support keyboard layout synchronization, such as the Nexus 5x
  • The keyboard layout can only be synced from the client to the server. When changing the server-side keyboard layout, the client keyboard layout cannot be changed.
  • When you change the client keyboard layout to a non-compatible layout, the layout might be synced on the VDA side, but functionality cannot be confirmed.
  • Remote applications that run with elevated privileges (for example, applications you run as an administrator) can’t be synchronized with the client keyboard layout. To work around this issue, manually change the keyboard layout on the VDA or disable UAC.

USB smart card

Citrix Workspace app provides support for USB smart card readers with StoreFront, Web Interface-based site, or a PNA site. You can use USB smart cards for the following purposes when enabled:

  • Smart card logon - Authenticates users to Citrix Workspace app.
  • Smart card application support - Enables smart card-aware published applications to access local smart card devices.

Citrix Workspace app supports this feature on all Android devices listed by Biometric Associates.

Citrix Workspace app supports the following types of USB smart cards:

  • Personal Identity Verification (PIV) cards
  • Common Access Cards (CAC) cards

USB smart card is supported on Android operating system 6.0(Marshmallow) to Version 7.12(Nougat). Android operating system Version 8.0(Oreo) and 9.0(Pie) are not supported. This is a third-party limitation.

You can also enable USB smart card authentication from Settings > Manage Accounts.

Configuring USB smart card


  • Download and install the Android PC/SC-Lite service from the Google Play Store.
  1. Connect the USB smart card reader to the mobile device. For information about connecting smart card readers, refer to the smart card reader specifications provided by the manufacturer.
  2. Add a smart card enabled StoreFront account.
  3. On the Citrix Workspace app logon page, tap Add Account. Tap the Use Smartcard option.
  4. To edit an existing account to use the USB smart card authentication, tap Accounts > Edit and tap the Use Smartcard option.

File type association

As a prerequisite for this feature to work, go to the Citrix Workspace app settings and set the Use device storage option to Full Access. An additional option, Ask every time is also available so that you are prompted for permission before accessing your device storage in a session.


Ask every time option is a per-session setting. It does not carry forward to the next session.

When you select Ask every time, any system-generated access to your device storage might cause the Use device storage prompt to appear (for example, at logoff). This is expected behavior.

Citrix Workspace app reads and applies the settings configured by administrators in Citrix Studio. To apply FTA in a session, ensure that users connect to the Store server where the FTA is configured.

On the user device, select the file you want to launch File Explorer and click Open. The Android operating system provides an option to launch the file using Citrix Workspace app (applying the FTA configured by the administrator) or a different application. Depending on your earlier selection, a default application might or might not be set. You can change the default application using the Change default option.


This feature is available only on StoreFront and requires Citrix Virtual Apps and Desktops Version 7 or later.

File type association (FTA) with Google Drive

When using a Chromebook, you can access files residing on Google Drive from Citrix Workspace app using the file type association (FTA) feature. You can seamlessly use Android applications available on Chromebooks to access these files. For example, if you save a .doc file to Google Drive, you can open the file using an Android application (in this case, Microsoft Word) on the Chromebook from within Citrix Workspace app.


Only Chromebook devices support FTA with Google Drive.

Enabling access to files on Google Drive:

  1. Download the Citrix File Access component (FileAccess.exe) from the Citrix Workspace app for Chrome download page and install it on the VDA.
  2. Using Citrix Studio, configure the appropriate file type associations (FTAs) for published applications. FTAs can be configured from the respective application properties or settings. For more information about how to set FTA, see Knowledge Center article CTX218743.
  3. In a Citrix Virtual Apps and Desktops session, open the default browser, add the following URL to the trusted sites: and
  4. On the Chromebook device, select the file you want to launch. Tap Open and select Citrix Workspace app from the list.

Known issues and limitations

  1. Smart card authentication might be slower than password authentication. For example, after disconnecting from a session, wait for approximately 30 seconds before attempting to reconnect. Reconnecting to a disconnected session too quickly might cause Citrix Workspace app to turn unresponsive.
  2. Smart card authentication is not supported on XenApp Services Sites.
  3. Some users might have a global PIN number for smart cards; however, when users log on using a smart card account, they must enter the PIV PIN and not the global smart card PIN. This is a third-party limitation.
  4. Citrix recommends that you exit and restart the Citrix Workspace app session after you log off from the smart card account.
  5. Multiple USB smart cards are not supported.
  6. You can access only MIME file formats supported by Microsoft Office, Adobe Acrobat reader and Notepad applications using the file type association feature.