About this release

Note:

Looking for features in Technical Preview? We have curated a list so that you can find them in one place. Explore our Features in Technical Preview page and share your feedback using the attached Podio form link.

What’s new in 2309

Scan code input mode

Citrix Workspace app allows you to use external physical keyboards to collaborate with the server-side keyboard layout on the VDA. When administrators enable Scan code mode, the end user might find themselves using the keyboard layout of the server instead of the client.

This feature enhances the user experience particularly when using an East-Asian language physical keyboard.

Notes:

• By default, this feature policy is disabled.
• On touch devices, when Scan code is enabled, the on-screen software keyboard doesn’t work from the Citrix Workspace app.

Configuration

You can configure the Scan code input method in the following way:

• Configuration.js

Configuration.js

Notes:

• Citrix recommends you back up the configuration.js file before making changes.
• Administrator-level credentials are required to edit the configuration.js file.
• The configuration.js file is located under the C:\Program Files\Citrix\HTML5Client folder.

To enable the Scan code support feature, do the following:

1. Navigate to the configuration.js file.

2. Edit the file and set the scancode attribute to true.

   The following is an example of JSON data:

   "features" : {
           "ime": {
                       "scancode": true,
   }
   }
   <!--NeedCopy-->
   

3. Save the changes.

Fixed issues in 2309

• When you are in a virtual app session, the cursor moves, but the pointer icon does not change according to the specific application area. [CVADHELP-23499]
• When the WebAssembly (.wasm) files are blocked in your network, the Citrix Workspace app session might not start. [RFHTMCRM-10801]

Known issues in 2309

• There are no known issues.

Note:

• For a complete list of issues in the earlier releases, see Known issues section.

Earlier releases

This section provides information on the new features and fixed issues in the previous releases that we support as per the Lifecycle Milestones for Citrix Workspace app.

2308

What’s new

This release addresses areas that improve overall performance and stability.

Fixed issues in 2308

• When you use the French keyboard layout on the client device, some punctuation keys might appear incorrectly in the VDA session. The issue occurs when you start a session using the Mozilla Firefox browser on a macOS device. [RFHTMCRM-8708]
• On touch devices, when you use zoom in and zoom out gestures in a session, the in-session toolbar position might appear incorrectly. [RFHTMCRM-10264]
• When you launch a session on any browser on an iPad with a physical keyboard attached, the key combinations like Command+a, Command+c, and Command+x might not work as expected. The issue occurs when you start a Linux VDA session. [RFHTMCRM-5917]

2307

What’s new

Enhancement to HDX session experience

With an enhanced compression technique, Citrix Workspace app for ChromeOS consumes low network resources and improves session responsiveness.

Microsoft Teams enhancements

Microsoft Teams optimization supports real‑time transcription of what the speaker is saying when Live Captions is enabled in Microsoft Teams.

Fixed issues in 2307

• The session launch progress notification window that appears at the lower right of the screen might not close even after the session starts. The issue occurs when the VDA version is 7.15. [RFHTMCRM-10161]

Known issues in 2307

There are no new known issues in this release.

2306

What’s new

Improved virtual apps and desktops launch experience

Starting with the 2306 release, the improved app and desktop launch experience provide timely and relevant information about the launch status.

Note:

Administrators must upgrade HDX SDK files to use Citrix Workspace app for HTML5 2306 version. The older HDX SDK files are incompatible with the 2306 version and later. To download the latest HDX SDK files, click here. For more information, see the Citrix Workspace app for HTML5 HDX SDK developer docs.

Fixed issues in 2306

• When you are in an optimized Microsoft Teams meeting, the camera streaming fails. The video appears blurry and sometimes the video can become unresponsive. The issue occurs when the screen sharing feature is disabled, and the end user enables the camera in a Microsoft Teams meeting. [RFHTMCRM-9968]
• When sessions are in tablet mode, any touch device’s stylus pen might not function. [RFHTMCRM-9951]
• On cloud deployments, the HTML5 session tab didn’t wait for the VDI to power on. Instead, the session tab displayed error messages related to the ICA connection. The issue occurs when the session timed out before the VDI has powered on. [RFHTMCRM-9414]

2305

What’s new

Enhancements to Virtual Channel SDK

Starting with the 2305 release, Citrix Workspace app for HTML5 supports Window Management APIs in Virtual Channel SDK. Web APIs enable IT administrators to create interactive applications and customize them for their end users.

Fixed issues

• When you use custom domain store URLs, the Citrix Workspace app session might fail to start. [RFHTMCRM-8482] [RFHTMCRM-9406]

• When you use Microsoft Teams, the incoming video or screen sharing might not appear with specific multi-monitor layouts. The issue occurs when the extended monitor is on the left or at the top. The video area can appear black or white. [RFHTMCRM-9159]

• In multi-monitor mode, if you resize the primary monitor window to full-screen, the incoming video or the screen sharing preview video might be invisible.

  The issue occurs when the window is in extended mode, and the resolution of the primary screen is of a lower value than the secondary screen. [RFHTMCRM-9277]

• In a session, when two participants are in the optimized Microsoft Teams meeting, the screen sharing and audio might fail. The issue occurs when you enable and disable the camera several times during the call. [CVADHELP-22251]

• When you upgrade your device to ChromeOS version 108, text on the published desktop might appear blurred. The issue occurs on devices where the graphical processing unit (GPU) doesn’t support medium precision. [CVADHELP-22362]

  Note:

  • Some devices’ display settings don’t support high precision, and the text on the published desktop might appear correctly. However, the display might appear abnormal because of this fix. To correct it, administrators can set the webglHighPrecision attribute to false in the configuration.js file.

  Following is an example of JSON data:

   "hardware" : {
  
       "webglHighPrecision" : false
   },
   <!--NeedCopy-->
  

2304

What’s new

Gesture enhancements on touch devices

Starting with the 2304 release, Citrix Workspace app enhances end user experience for:

• gestures, multi-touch, and soft keyboard functionality on mobile devices.
• soft keyboard functionality on Tablet mode.

In your Citrix Workspace app sessions, you can use all the familiar multi-touch gestures, including the tap, swipe, drag, pinch, and zoom.

Following is the gesture guide:

To do this:	On Citrix Workspace app, do this:
Single click	One-finger tap
Right-click	Touch-hold-release
Open the on-screen keyboard	Three-finger tap (or from the toolbar, tap Keyboard icon)
Zoom	Pinch in and out
Drag	Touch, hold, and slide
Enable cursor	Two-finger tap

Fixed issues

• There are no fixed issues in this release.

2303

What’s new

Plug and Play audio device support

Previously, only a single audio playback and recording device was supported and displayed as Citrix HDX Audio irrespective of the real device name.

Starting with the 2303 version, you can connect multiple audio devices and redirect them to VDA. When you redirect USB audio devices, you can now view the real name of the audio device under the Sound settings > Playback and Sound settings > Recording on the VDA. The list of devices on the VDA is dynamically updated whenever an audio device is plugged in or removed.

Note:

• By default, this feature is enabled.

For more information, see Plug and Play audio device support.

Client Drive Mapping

Previously, you couldn’t copy files from your local machine to the virtual environment. In a session, you couldn’t access local drives directly from the file explorer.

Starting with the 2303 version, the Client Drive Mapping (CDM) feature supports folder mapping on the local machine so they’re accessible from within a session. You can map any folder from the local machine, if the folder doesn’t contain system files.

The end user can do the following operations:

• Copy files and folders from the local machine to the mapped drive in the session.
• View the list of files and folders in the mapped drive.
• Open and read file contents in the mapped drive.
• View the file properties (modified time and file size only) in the mapped drive.

This feature provides the advantage of accessing both virtual desktop drives and local machine drives together in the file explorer within the HDX session. This feature is supported on desktop platforms, Google Chrome, and Microsoft Edge Chromium browsers only.

Note:

By default, this feature is enabled.

For more information, see Client Drive Mapping.

Background blurring and effects in Microsoft Teams optimization

Starting with the 2303 release, Citrix Workspace app for HTML5 supports background blurring and effects in Microsoft Teams optimization for video calls. You can either blur or replace the background effects provided by Microsoft Teams to avoid unexpected distractions by helping the conversation stay focused on the silhouette (body and face). This feature can be used with P2P and conference calls.

Notes:

• By default, this feature is disabled.
• This feature is now integrated with the Microsoft Teams UI. Multi-window support is a prerequisite that requires a VDA update to 2112 or higher. For more information, see Multi-window meetings and chat.

For more information, see Background blurring and effects in Microsoft Teams optimization.

Combo box support on mobile platforms

Starting with the 2303 version, selecting UI elements within a combo box on small screens is smoother. An administrator can enable the policy Remote the combo box to make the user experience of selecting checkboxes, drop-down list options, radio buttons, and more a smooth experience on iOS and Android mobiles.

For more information, see Remote the combo box in the Citrix Virtual Apps and Desktops documentation.

Note:

This feature is enabled by default.

For more information, see Combo box support on mobile platforms.

Fixed issues

• In cloud deployments, the enhanced PDF printing fails. The print preview doesn’t appear. [RFHTMCRM-8691]

2301.1

This release addresses a few issues that help to improve overall performance and stability.

Fixed issues

• The audio device redirection to the Citrix Virtual Apps and Desktops session isn’t working. A red ‘X’ mark appears on the volume toggle icon in the system tray. The issue occurs after you update the Citrix Workspace app for HTML5 with the 2301 version. [RFHTMCRM-8799]

2301

What’s new

Multi‑window chat and meetings for Microsoft Teams

Starting with the 2301 version, you can use multiple windows for chat and meetings in Microsoft Teams. You can pop out the conversations or meetings in various ways.

For details about the pop‑out window feature, see Pop out a chat in Microsoft Teams.

For troubleshooting see, CTX253754.

Microsoft will deprecate the single‑window support in the future. If you’re running an older version of Citrix Workspace app or Virtual Delivery Agent (VDA), you can upgrade to:

• Citrix Workspace app 2301 or later and
• VDA - 2203 or later

Plug and Play audio device support

Previously, only a single audio playback and recording device was supported and displayed as Citrix HDX Audio irrespective of the real device name.

Starting with the 2301 release, we support multiple audio devices and redirect them to VDA. Now, when you redirect audio devices, you can view the real name of the audio device under the Sound settings > Playback and Sound settings > Recording on the VDA. The list of devices on the VDA is dynamically updated whenever an audio device is plugged in or removed.

For more information, see Plug and Play audio device support article.

Fixed issues in 2301

• Webcam redirection isn’t working when you use Citrix Virtual Apps and Desktops version 2206 and later. With the latest fix, the webcam redirection is successful from Citrix Workspace app for HTML5 version 2301 and later. [RFHTMCRM-8580]

• In the multi-monitor mode, a white patch is observed inside the session. The issue occurs when you block pop-ups for Citrix Workspace app for HTML5 sessions on Google Chrome and Microsoft Edge Chromium browsers. [RFHTMCRM-8476]

• When you use a Chromebook and attempt to call from optimized Microsoft Teams, the call doesn’t work as expected. The following error message appears:

  “Sorry, it wasn’t possible to connect”. [CVADHELP-21670] [CVADHELP-21500]

• When you push Global App Configuration service settings, the changes might not apply occasionally. [RFHTMCRM-8710]

2212

What’s new

Client Drive Mapping [Technical Preview]

Previously, copying files from your local machine to the virtual environment required you to upload the file to the virtual session and download the files from the virtual session. You weren’t able to access local drives directly from the File Explorer in a session.

Starting with this release, the early version of the client drive mapping (CDM) feature supports folder mapping on the local machine, making it accessible from within a session. You can map any folder from the local machine, provided the folder doesn’t contain system files. After you map the folder, it appears as an L: drive inside the sessions.

The end user can do the following operations:

• Copy files and folders from the local machine to the mapped drive in the session.
• View the list of files and folders in the mapped L: drive.
• Open and read the file contents in the mapped L: drive.
• View the file properties (modified time and file size only) in the mapped L: drive.

This feature provides the advantage of accessing both virtual desktop drives and local machine drives together in the file explorer within the HDX session. This feature is supported on Google Chrome and Microsoft Edge Chromium browsers only. By default, this feature is disabled.

Note:

• This feature is a request-only preview. To get it enabled in your environment, fill out the Podio form.

Fixed issues

• When you enable multi-touch mode, some touch actions might not work within the Citrix Workspace app session. [RFHTMCRM-8445]

2211

What’s new

Automatic display of virtual keyboard

Starting from this release, a virtual keyboard automatically appears when you place the cursor on an editable field. This feature enhances the user experience on touchscreen devices, unlike the previous behavior where you had to click the keyboard icon to view the virtual keyboard.

Adaptive audio

With adaptive audio, you don’t need to configure the audio quality policies on the VDA. Adaptive audio optimizes settings for your environment. It replaces legacy audio compression formats to provide an excellent user experience.

For more information, see Adaptive Audio in the Citrix Virtual Apps and Desktops documentation.

For information on how to configure, see Adaptive audio documentation.

Fixed issues in 2211

• When you share your screen to present a Virtual Desktop Infrastructure (VDI) session with the administrator, you can see both the administrator’s and your mouse pointers on the screen. [RFHTMCRM-7726]

2210

What’s new

Adaptive audio [Technical Preview]

With Adaptive audio, you don’t need to configure the audio quality policies on the VDA. Adaptive audio optimizes settings for your environment. It replaces legacy audio compression formats to provide an excellent user experience.

For more information, see Adaptive Audio in Citrix Virtual Apps and Desktops documentation.

For information on how to configure, see Adaptive audio documentation.

Fixed issues

• When the Windows client keyboard layout is Korean, the last character that is in the composition window gets deleted after pressing the Enter Key. The issue occurs when you launch any Secure Browser Service (SBS) app session. [RFHTMCRM-7449]

2209

What’s new

Microsoft Teams optimization screen sharing

In earlier versions, the screen sharing functionality was disabled by default. Starting with version 2209, by default, the screen sharing is enabled. The end users can now share apps and tabs that are opened through Citrix Workspace app.

For more information, see Screen sharing section.

Fixed issues

• In multi-monitor mode, when you click the Close button (X) to switch to normal mode, the action might not work as expected. As a workaround, use the Restore button from the session toolbar to switch from the multi-monitor mode to normal mode. [RFHTMCRM-7403]
• In a session, when three or more participants are in the optimized Microsoft Teams meeting, the screen sharing functionality might not work as expected. The issue happens intermittently. [RFHTMCRM-7409]
• When you join an external meeting from the optimized Microsoft Teams, the audio from the participant doesn’t work as expected. The following error message appears: “Couldn’t find a microphone”. As a workaround, quit the Microsoft Teams app and rejoin. [CVADHELP-20625]

2208

What’s new

Multi-monitor support

Previously, the multi-monitor display feature allowed you to open an extra browser tab of the desktop or app session that you were connected to. You could then drag the additional browser tab to the external monitor.

Now, Citrix Workspace app supports multiple monitors with one click without manual intervention.

For more information, see Multi-monitor support in the Configure section.

Provision to disable LaunchDarkly service

Starting with this release, you can disable LaunchDarkly service on both on-premises and cloud stores.

For more information, see Feature flag management section.

Fixed issues

• In a session, when there are three or more participants in the optimized Microsoft Teams meeting, the video of the participants might freeze. The issue occurs intermittently. [RFHTMCRM-7251]
• When you use an HTML5 session in the Mozilla Firefox browser, the Quick Find bar appears when you press the backslash key in the external monitor window. The issue occurs when you are in multi-monitor mode. [CVADHELP-20396]
• When you use an HTML5 session in the Mozilla Firefox browser, the mouse-scrolling functionality might not work in the secondary window. The issue occurs when you are in multi-monitor mode. [CVADHELP-20306]
• In the optimized Microsoft Teams video call, when you add the third participant, the call drops. [CVADHELP-20586]

2207

What’s new

This release addresses issues that help to improve overall performance and stability.

Fixed issues

This release addresses issues that help to improve overall performance and stability.

2206

What’s new

Microsoft Teams optimization

Microsoft Teams optimization supports audio call, video call, and screen sharing functionalities on the Google Chrome browser only. The minimum Google Chrome version required is m97 and later.

For more information see, Microsoft Teams optimization in the configure section.

Logging enhancements

Previously, the client logs and console logs had to be collected separately. Starting with this release, the console logs are a part of the client logs.

Clipboard supports HTML format

Starting with this release, you can use HTML format for clipboard operations between the virtual desktop and the endpoint device. When you copy the HTML data, the source content format is copied, and when you paste the data, the destination content carries the formatting. In addition, HTML format provides a better look and feel.

For more information on how to set the policies, see Client clipboard write allowed formats in the Citrix Virtual Apps and Desktops documentation.

Virtual Channel SDK support

With this release, the Citrix VC SDK supports writing server-side applications and client-side drivers using the ICA protocol. The server-side virtual channel applications are on the Citrix Virtual Apps and Desktops server.

VC SDK supports writing new virtual channels and Citrix Workspace app for HTML5 can support up to 20 custom-virtual channels.

For more information see, Virtual Channel SDK support in the configure section.

Multi-monitor support [Technical Preview]

Previously, the multi-monitor display feature allowed you to create an extra browser tab of the desktop or app session that you were connected to. You could then drag the additional browser tab to the external monitor.

With this release, Citrix Workspace app supports multiple monitors with one click without manual intervention. If there are no external monitors attached to the device, the multi-monitor icon on the in-session toolbar isn’t visible. When you connect an external monitor with the required permissions, the multi-monitor icon is visible. After you click the icon, you can see the window span on all the connected monitors.

For more information see, Multi-monitor support [Technical Preview] in the configure section.

Fixed issues

• After you update the Citrix Workspace app version to 2112 or later, a desktop session on the Internet Explorer browser fails. The following error message appears: ‘Store’ is undefined.

  The issue occurs because of an internal code error. [CVADHELP-19883]

2205.6

What’s new

This release addresses issues that help to improve overall performance and stability.

Fixed issues

• If the administrator has rolled out any settings through Global App Configuration Service (GACS), Citrix Workspace app might not apply those settings. [RFHTMCRM-7198]

Known issues

Known issues in 2203

• Webcam redirection might not work in some Citrix Virtual apps and Desktops or XenDesktop. [HDX-39396]

Known issues in 2202

• When you use Microsoft Teams optimization and share the screen, a red border that indicates the screen sharing is unavailable. [RFHTMCRM-6360]

Known issues in 2108.2

When Use Video Codec for Compression is set to For the Entire Screen in Citrix Studio, a multi-monitor session might render incorrectly. We recommend changing the setting to Use when preferred in multi-monitor sessions. [RFHTMCRM-5523]

Known issues in 2105.5

• The input of the first character might not appear exactly at the location of the workspace session’s cursor position. [RFHTMCRM-4909]
• When a CJK Generic Client IME user single-clicks a cell to type in Microsoft Excel, the Candidate and Composition Window UI might not appear at the focus position. As a workaround, double-click the cell. [RFHTMCRM-5185]

Legacy documentation

For product releases that have reached End of Life (EOL), see Legacy documentation.

Limitations

• Disconnecting from a session: When you disconnect from a session by closing a tab or closing the browser, the server might not get notified that the session was disconnected. As a result, the session on the server remains active for the default 180 seconds or the configured session reliability timeout.

  Recommendation: We recommend that you disconnect the session through the toolbar option.

• When Use Hardware Encoding for Video Codec is set to Enabled in Citrix Studio, your screen might appear green during a session through an Intel vGPU VDA. [RFHTMCRM-5521]

• The server falls back to YUV420 even when configured to Graphics-Thinwire YUV444 setting. The graphics-rich applications are limited to the YUV420 range. [RFHTMCRM-5520]

• In a session, when you try to send command + R key combination prompts to disconnect the session instead of remoting to the session. The issue occurs when you use the Safari browser application. [RFHTMCRM-6415]

• When you use Microsoft Teams optimization and share the screen, a red border that indicates the screen sharing is unavailable. [RFHTMCRM-6360]

• External mouse and keyboard aren’t supported with Citrix Workspace app for HTML5 in any browser on Android or iOS operating systems. [RFHTMCRM-6623]

• When you close the browser or the browser tab to disconnect the session, the session state might remain active on the server (Delivery Controller) for sometime. The issue occurs intermittently.

  As a workaround, use the Disconnect option from the secondary menu in the session toolbar. [RFHTMCRM-5457]

• Horizontal scroll from a touchpad isn’t supported.

• When you connect multiple audio devices in a session, you can hear audio from one device only. You might not be able to switch to the other audio device. [HDX-49312]

• In a session, you might not hear the audio from some applications when you disconnect and reconnect to your previous session though toolbar. [HDX-49313]

• Anonymous logins to Citrix Virtual Apps and Desktops from devices with different Device IDs across sessions can sometimes lead to an incorrect user or device license count.

• In a session, when you open Microsoft Excel and perform a cut-and-paste operation using a keyboard, the text in the cell isn’t cleared after the cut action. [RFHTMCRM-10426]

Legacy documentation

For product releases that have reached End of Life (EOL), see Legacy documentation.