About this release

What’s new in 2205

Note:

From this release onward, ensure that Microsoft Edge WebView2 Runtime version is 99 or later. For more information, see System requirements and compatibility.

Change to Citrix Casting

Previously, Citrix Casting was enabled by default during the Citrix Workspace app installation. Starting from this release, Citrix Casting is enabled only if you run Citrix Workspace app installer with the /IncludeCitrixCasting command during installation. When you update Citrix Workspace app, the Citrix Casting gets updated automatically. For more information on Citrix Casting, see Citrix Casting.

Quick access to resources

Starting from this release, you can get quick access to your recently used apps, desktops, and files. Right-click on the Citrix Workspace app icon in the taskbar to view and open the recently used resources from the pop-up menu.

Quick access to resources

Sign out custom web store upon CWA exit

Starting from this release, admins can configure Citrix Workspace app in such a way that it exits when you sign out or close custom web stores. Admins can configure this by setting signoutCustomWebstoreOnExit attribute to True in the Global App Configuration Service.

For more information, see Global App Configuration Service documentation.

Support to open Workspace app in maximized mode

Starting from this release, you can choose to open the Citrix Workspace app in maximized mode. Instead of maximizing the Citrix Workspace app manually every time, you can set the maximise workspace window property in the Global App Configuration Service to enable the Workspace app to open in the maximized mode by default.

For more information about the Global App Configuration Service, see Getting Started.

Storebrowse support for Workspace

Starting from this release, Citrix Workspace app for Windows provides Storebrowse support to Self-Service. This enables Storebrowse users to access Cloud and Workspace features.

Note:

For more information, see Storebrowse for Workspace.

Citrix Workspace Browser

This release includes Citrix Workspace Browser version 99.1.1.8, based on Chromium version 99. For features or bugs fixes in the Citrix Workspace Browser, see What’s new in the Citrix Workspace browser documentation.

Fixed issues in 2205

User interface

  • In Citrix Workspace app for Windows, non-admin users might not be able to disable the Data Collection setting through the Advanced Preferences dialog. [RFWIN-26795]

Session/Connection

  • When you restart Microsoft Teams, the existing HdxRtcEngine.exe process might not close and might start a new process.[HDX-40006]

  • During a peer-to-peer call with Microsoft Teams HDX optimization, app window sharing might fail to stop after a high number of start/stop sharing repetitions, and you might not be able to share desktop screen or app window, call or receive an incoming call until you restart Citrix Workspace app. [HDX-39549]

  • During Give Control session with Microsoft Teams HDX optimization, the remote cursor is drawn slightly offset from its actual position. [HDX-36376]

  • When you access a VDA for the first-time using Citrix Workspace app for Windows version 2112 or later, the following security message might appear:

    An Online Application is attempting to access information on a device attached to your computer HDX File Access.

    In previous versions, this message was present only during the first access to each published resource in a Delivery Group and not every VDA.

    [CVADHELP-19636]

Install, Uninstall, Upgrade

  • When you upgrade Citrix Workspace app for Windows, the following extra registry key might be created:

    HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\WOW6432Node\Citrix

    The issue occurs when the auto-update command line policy is configured.

    The TransparentKeyPassthrough registry value in HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Keyboard is not preserved on a 32-bit machine.

    [CVADHELP-19625]

Known issues in 2205

  • In Citrix Workspace app for Windows, the Advanced Audio Coding (AAC) supports only a maximum of 6 channels. [CTXBR-2941]

  • Battery status notification and automatic keyboard pop-up dialog might not appear during the session when Automatic keyboard display policy is enabled on the DDC. [HDX-39558]

  • When you plug-in an USB device or access files, Citrix Workspace app might show legacy Citrix Workspace - Security Warning dialog. [LCM-10369]

Earlier releases

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

2204.1

What’s new

Audio redirection enhancement

Improved audio echo cancellation support for all audio codecs including Adaptive audio and all legacy audio codecs.

Support for an enhanced Single sign-on (SSO) experience for web and SaaS apps [Technical Preview]

This feature simplifies the configuration of SSO for internal web apps and SaaS apps while using third party identity providers (IdPs). The enhanced SSO experience reduces the entire process to a few commands. It eliminates the mandatory prerequisite to configure Citrix Gateway Service in the IdP chain to set up SSO. It also improves the user experience, provided the same IdP is used for authentication to both the Workspace app and the particular web or SaaS app being launched.

You can register for this technical preview by using this Podio form.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and to give customers an opportunity to share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren’t deployed in production environments.

Citrix Workspace Browser

This release includes Citrix Workspace Browser version 98.1.2.20, based on Chromium version 98. For features or bugs fixes in the Citrix Workspace Browser, see What’s new in the Citrix Workspace browser documentation.

Microsoft Teams optimization

  • Support for secondary ringer: You can use the Secondary ringer feature to select a secondary device on which you want to get the incoming call notification when Microsoft Teams is optimized (Citrix HDX optimized in About/Version). For example, if you have set a speaker as the Secondary ringer and your endpoint is connected to headphones, Microsoft Teams sends the incoming call signal to the speaker even though your headphones are the primary peripheral for the audio call itself. If you aren’t connected to more than one audio device, or if the peripheral is not available (for example, Bluetooth headset), you can’t set a secondary ringer.

    Note:

    This feature is available only after the roll-out of a future update from Microsoft Teams. To know when the update is rolled-out by Microsoft, see the Microsoft 365 roadmap. You can also refer to CTX253754 for the documentation update and the announcement.

  • App Protection and Microsoft Teams enhancement: Microsoft Teams supports incoming video and screen sharing when Citrix Workspace app for Windows with App Protection enabled is on Desktop Viewer mode only. Published apps in seamless mode don’t render incoming video and screen sharing.

Fixed issues

Session/Connection

  • Citrix ADC appliance might crash when certain conditions are triggered from Citrix Workspace app for Windows. [HDX-39496]

  • In Citrix Workspace app, you might experience intermittent failures when answering or making a Microsoft Teams call. The following error message appears:

Call could not be established.

[HDX-38819]

  • When you try to redirect to the preferred webcam as set in the Citrix Workspace app for Windows, the setting might not be executed as configured.

    With this fix, the preferred webcam will be the only available webcam in the user session. This provides better control when multiple webcams are available in the user session.

    [HDX-38214]

  • If Citrix Workspace app is configured to show apps in Desktop and Start menu shortcut folder, then launching apps and desktop session from the Desktop or Start menu post Citrix Workspace app exit might result in failure. [RFWIN-26508]

  • Attempts to add the Citrix Gateway URL might fail intermittently with the following error message:

    Authentication Service cannot be contacted.

    [CVADHELP-19415]

  • With this fix, you can set TWITaskbarGroupingMode to GroupNone under the HKEY_LOCAL_MACHINE root registry tree, instead of setting it under both HKEY_CURRENT_USER and HKEY_LOCAL_MACHINE. The TWITaskbarGroupingMode key is available under HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Virtual Channels\Seamless Windows. [CVADHELP-19106]

Install, Uninstall, Upgrade

  • When customers use app personalization service, the Workspace installer might hang while validating the certificate. [RFWIN-21122]

2202

What’s new

Storebrowse support for Workspace (Technical preview)

Starting from this release, Citrix Workspace app for Windows provides Storebrowse support to Self-Service. This enables Storebrowse users to access Cloud and Workspace features.

Note:

For more information, see Storebrowse for Workspace.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised not to deploy Beta builds in production environments.

Citrix Workspace Browser

For features or bugs fixes in the Citrix Workspace browser, see What’s new in the Citrix Workspace browser documentation.

Note:

The system requirements for Citrix Workspace 2202 for Windows have changed as follows:

  • Minimum .NET version required is 4.8.
  • Minimum VCRedist version required is 14.30.30704.0.

Fixed issues

Install, Uninstall, Upgrade

  • When you upgrade Citrix Workspace app for Windows from Version CU4 to Version CU5 without installing self-service, the following prompt might appear:

    Upgrading from Unsupported Version

    Citrix Workspace will automatically uninstall your old version and delete all your settings, which you can restore later. Otherwise you will have to delete everything manually. Click OK to continue.

[CVADHELP-18790]

  • Attempt to refresh or launch an app results in the cannot contact store error message. This issue happens when the retrieval of shortcut description for specific subscribed apps fails.

Your apps are not available at this time. Please try again in a few minutes or contact your help desk with this information: cannot contact store.

[CVADHELP-18736]

Session/Connection

  • The Print Screen key might not capture screenshots when Citrix Workspace app for Windows with App Protection enabled starts in the background. [RFWIN-25835]
  • Starting a published application through a PNAgent site on StoreFront using Citrix Workspace app for Windows might fail with the following error message:

    Cannot start app. Please contact your help desk.

[CVADHELP-19209]

  • Launching sessions from Delivery Groups with an access policy rule specifying the client IP address might fail if the client has multiple NICs.

    Rule: Set-BrokerAccessPolicyRule -Name <rulename> -includedClientIPs <Client ip address>

[CVADHELP-18783]

  • Shortcuts for published applications through Citrix Workspace app cannot be created without appropriate permissions. As a result, the icons might be downloaded in the user profile at every refresh, increasing the cache size on the endpoints and the CPU consumption in the StoreFront side. [CVADHELP-18609]
  • After you configure a store through Group Policy Object or the command, refreshing the self-service UI opened from the notification area or the Start menu might fail. A Cannot contact server message appears. [CVADHELP-19242]
  • Virtual Desktop prompts you to enter credentials although domain pass-through is configured. This issue occurs when you launch a virtual desktop from the Citrix Workspace app. [RFWIN-26111]
  • In Citrix Workspace app 2112.1, you might experience high CPU utilization on endpoint when webcam is turned on in an optimized Microsoft Teams video call. [HDX-37168]

2112.1

What’s new

Support for local app discovery within the Citrix Workspace app

Starting with this release, admins can configure the discovery and enumeration of locally installed applications within the Citrix Workspace app. You can configure this feature by using the Global App Configuration Service. For more information about configuring this feature, see Global App Configuration Service. This feature is ideal for devices that runs in the kiosk mode and for those applications that can’t be virtualized within the Citrix Workspace.

Service continuity

During an outage in the identity provider for workspace authentication, users might be unable to sign into Citrix Workspace through the Workspace app sign-in screen. The message Having trouble signing in? Use Workspace offline appears at the top of the Citrix Workspace app sign-in screen.

Click Use Workspace offline to enumerate all the apps and desktops that have valid Connection Leases stored on the client device.

From this release, the message appears after 40 seconds time out. For more information, see Service continuity section in the Citrix Workspace documentation.

Improved virtual desktop experience

This release improves the experience when resizing virtual desktops.

Improved ICA file security

In earlier releases, the ICA file downloads to the local disk when you launch a virtual apps and desktops session.

With this release, we provide enhanced security in the way Citrix Workspace app handles ICA files during a virtual apps and desktops session launch.

Citrix Workspace app now lets you store the ICA file in the system memory instead of the local disk. This feature aims to eliminate surface attacks and any malware that might misuse the ICA file when stored locally. This feature is also applicable on virtual apps and desktops sessions that are launched on workspace for web. For more information, see Improved ICA file security section.

Adaptive audio update

Adaptive audio now works when using UDP audio delivery. For more information, see Adaptive audio.

Microsoft Teams optimization

Note:

The following features are available only after the roll-out of a future update from Microsoft Teams. When the update is rolled-out by Microsoft, see Microsoft 365 roadmap, you can also check CTX253754 for the documentation update and the announcement.

  • Multi-window chat and meetings for Microsoft Teams

    With this release, you can use multiple windows for chat and meetings in Microsoft Teams, when optimized by HDX in Citrix Virtual Apps and Desktops 2112 or higher. You can pop out the conversations or meetings in various ways. For details about the pop-out window feature, see Teams Pop-Out Windows for Chats and Meetings on the Microsoft Office 365 site.

    If you’re running an older version of Citrix Workspace app or Virtual Delivery Agent (VDA), remember that Microsoft will deprecate the single-window code in the future. However, you will have a minimum of nine months after this feature is GA to upgrade to a version of the VDA or Citrix Workspace app that supports multiple windows (2112 or higher).

  • App sharing

    Previously, you were not able to share an app using the Screen sharing feature in Microsoft Teams when you enable the HDX 3D Pro policy in Citrix Studio.

    Starting with Citrix Workspace app 2112.1 for Windows and Citrix Virtual Apps and Desktops 2112, you can share an app using the Screen sharing feature in Microsoft Teams, when this policy is enabled.

  • Give control

    You can use the Give control button to give control access of your shared screen to other users participating in the meeting. The other participant can make selections and modify the shared screen through keyboard, mouse, and clipboard input. You both now have control of the shared screen and you can take back the control anytime.

  • Take control

    During screen sharing sessions, any participants can request control access through the Request control button. The person sharing the screen can then approve or deny the request. When you have the control, you can control the keyboard and mouse input on the screen shared and release control to stop sharing control.

    Limitation:

    The Request Control option is not available during the peer-to-peer call between an optimized user and a user on the native Microsoft Teams desktop client that is running on the endpoint. As a workaround, users can join a meeting to get the Request Control option.

  • Dynamic e911

    With this release, Citrix Workspace app supports dynamic emergency calling. When used in Microsoft Calling Plans, Operator Connect, and Direct Routing, it provides the capability to:

    • configure and route emergency calls
    • notify security personnel

    The notification is provided based on the current location of the Citrix Workspace app that runs on the endpoint, instead of the Microsoft Teams client that runs on the VDA. Ray Baum’s law requires the 911 caller’s dispatchable location to be transmitted to the appropriate Public Safety Answering Point (PSAP). Starting from Citrix Workspace app 2112.1 for Windows, Microsoft Teams Optimization with HDX is compliant with Ray Baum’s law.

Citrix Workspace Browser

This release of the Workspace Browser is based on Chromium version 95.

Fixed issues

Install, Uninstall, Upgrade

If you’ve installed the Workspace app with a version earlier than 2109 as a user and the admin installs version 2109, an Entry point not found error message appears if you sign in to the device again as a user. When you click OK, the message disappears, and the Workspace app is updated to version 21.0.9. [RFWIN-25008]

Sign in/Authentication

  • Citrix Workspace app authentication might fail after initialization when attempted using a smart card through Citrix Gateway. If you refresh the authentication process after 15 minutes, a 404-error message might appear in an embedded browser within Citrix Workspace. This results in the app being stuck in an authentication loop until you close and reopen the app. [RFWIN-25006]
  • Adding a store with smartcard authentication might fail with this error message: This store doesn’t exist. Please retry or contact support. [CVADHELP-18647]
  • Performing enumeration of the application through Storebrowse adds null character between each character in the enumeration file. [CVADHELP-18773]

Session/Connection

  • Using the Storebrowse utility to enumerate resources for the Citrix Gateway URL might fail when at least one of the configured Delivery Controllers is not reachable. [CVADHELP-15416]
  • When attempting to open an application if the vPrefer option is enabled and one instance per user app limit is configured, a connection failure error might appear on the Citrix Director. [CVADHELP-17372]
  • Citrix Workspace app might poll external beacons for internal only stores. With this fix, external beacons are not polled for internal only stores or stores which do not have gateway associated with it. [CVADHELP-18275]
  • On Citrix Workspace app for Windows 2109 and higher, desktop session might disconnect when legacy graphics mode is enabled. [CVADHELP-18718]
  • When using App Protection with Citrix Workspace app for Windows 2109 or higher, performance of the graphics card might be poor. [CVADHELP-18831]
  • After Microsoft Edge WebView2 Runtime auto-upgrade, Citrix Workspace app for Windows shows a blank screen. [RFWIN-25295]
  • Citrix Workspace app stops working. [RFWIN-25301]
  • Handle leaks in App Protection components causes few processes to fail. [RFWIN-25358]
  • Citrix Workspace app Desktop Lock might fail when the GPO stores for the Desktop Lock setup are not configured. [RFWIN-25392]
  • In Microsoft Teams, screen sharing stops when you resize the session. [HDX-31858]
  • In multi-monitor mode, a blank screen appears when you disconnect the display while sharing the screen in Microsoft Teams. [HDX-34733]
  • During the screen sharing session, the red border indicating the shared screen spans across the screens, when Microsoft Teams is running in the seamless mode and multi-monitor setup. [HDX-34978]
  • You might experience call failures during a P2P call between Citrix Workspace app for Mac 2109 and Citrix Workspace app for Windows 2109. [HDX-35223]
  • During the Microsoft Teams video call, the camera might flash. [HDX-36345]
  • Attempts to launch a session might fail when you customize the StoreFront by setting the field value to ClientName in the default.ica file. For more information, see Citrix Knowledge Center article CTX335725. [CVADHELP-19033]

To know the existing issues within the product, see Known issues.

2109.1

What’s new

Support for Windows 11

Citrix Workspace app for Windows is now supported on the Windows 11 operating system.

Fixed issues

If your admin has installed external extensions in Google Chrome, the Citrix Workspace Browser crashes when you open it. [CTXBR-2135]

To know the existing issues within the product, see Known issues.

2109

What’s new

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 and replaces deprecated audio compression formats to provide an excellent user experience.

Note:

If UDP audio delivery is required for the real-time audio application, Adaptive audio must be disabled on the VDA to allow fallback to UDP audio delivery.

For more information, see Adaptive audio.

Citrix Workspace Browser

The Citrix Workspace Browser is a native browser running on the client machine. It lets users open web and SaaS applications from within the Citrix Workspace app in a secure manner.

Citrix Workspace Browser

With a continued focus on enriching the user-experience, the new browser brings you an enhanced and a more native browser-like user experience, complete with the following features:

  • VPN-less access to internal webpages
  • Microphone and webcam support
  • Tabbed browsing experience
  • Multi-window views
  • Editable omnibox
  • Bookmarks
  • Shortcuts on the new tab page
  • Customizable settings
  • Proxy authentication support
  • Analytics

Admins can enable Secure Workspace Access (SWA) or App protection policies in varying combinations on a per-URL basis. The functionalities include such as, anti-keylogging, anti-screen capture, download, printing, clipboard restrictions, and watermarking.

For more information, see Citrix Workspace Browser.

StoreFront to Workspace URL migration

As your organization move from on-prem StoreFront to Workspace, end users must manually add the new Workspace URL to the Workspace app on their end points. This feature enables the administrators to seamlessly migrate users from a StoreFront store to a Workspace store with minimal user interaction.

For more information about this feature, see StoreFront to Workspace URL Migration.

Support for custom web stores

With this release, you can access your organization’s custom web store from the Citrix Workspace app for Windows.

To use this feature, the administrator must add the domain or the custom web store to the allowed URLs list in the Global App Configuration Service. When you add, you can provide the custom web store URL in the Add Account screen in the Citrix Workspace app. The custom web store opens in the native Workspace app window.

For more information about configuring custom web store, see Custom web store.

Support for Windows Hello and FIDO2 Security Keys based authentication

With this release, you can authenticate to Citrix Workspace using Windows Hello and FIDO2 security keys.

For more information, see Other Ways to authenticate to Citrix Workspace.

Single Sign-On (SSO) to Citrix Workspace app from Microsoft Azure Active Directory (AAD) joined machines with AAD as identity provider

With this release, you can single sign-on to Citrix Workspace app from Azure Active Directory (AAD) joined machines with AAD as the identity provider.

For more information, see Other Ways to authenticate to Citrix Workspace.

Support for Conditional Access with Azure Active Directory

With this release, Workspace administrators can configure and enforce Azure Active Directory conditional access policies for users authenticating to Citrix Workspace app.

For more information, see Support for Conditional access with Azure AD.

Support for Service continuity

This release supports service continuity with Citrix Workspace Web Extensions. You can use Workspace Web Extensions for Google Chrome or Microsoft Edge with Workspace app for Windows 2109. These extensions are available at Google Chrome web store and the Microsoft Edge Add-on website. The Workspace app communicates with the Citrix Workspace Web extension using the native messaging host protocol for browser extensions. Together, the Workspace app and the Workspace Web extension use Workspace connection leases to give browser users access to their apps and desktops during outages. See Service continuity for more information.

Microsoft Teams enhancements

The following features are available only after the roll-out of a future update from Microsoft Teams.

When the update is rolled-out by Microsoft, you can check CTX253754 for the documentation update and the announcement.

  • Support for WebRTC: This release supports WebRTC 1.0 for a better video conferencing experience along with Gallery View.

  • Screen sharing enhancement: You can share individual applications, windows, or full screen using the screen sharing feature in Microsoft Teams. Citrix Virtual Delivery Agent 2109 is a prerequisite for this feature.

  • App Protection compatibility: When App Protection is enabled, you can now share content through Microsoft Teams with HDX optimization. With this feature, you can share an application window running in the virtual desktop. Citrix Virtual Delivery Agent 2109 is a prerequisite for this feature.

    Note:

    Full monitor or desktop sharing is disabled when App Protection is enabled for the delivery group.

  • Live captions: This release supports real-time transcription of what the speaker is saying when Live Captions is enabled in Microsoft Teams.

Microsoft Teams optimization

Citrix Workspace 2109 for Windows release supports peer-to-peer audio and video call, conference call, and screen sharing in optimized Microsoft Teams on VM hosted apps.

Support for Bloomberg keyboard 5

This release includes support for Bloomberg keyboard 5. To use Bloomberg keyboard 5, you must configure Registry editor. For more information about configuring the keyboard, see Configure Bloomberg keyboard 5 section in Bloomberg keyboards.

Fixed issues

Seamless Windows

Some third-party applications might remain in the foreground, keeping other launched applications in the background. [CVADHELP-16897]

User Interface

When using Citrix Workspace app for Windows, the Start menu shortcuts might not refresh automatically. The issue occurs when a new application is added, or a change is made on the back end. [CVADHELP-17122]

Client Device Issues

When using Citrix Workspace app, the devices connected with COM ports greater than 9 might fail to map within the session. [CVADHELP-17734]

Session/Connection

  • When you upgrade Citrix Workspace app for Windows to version 2106, application or desktop launch using a proxy server might fail with this error message:

    Unable to connect to the server. Contact your system administrator with the following error: There is no Citrix XenApp server configured on the specified address. (Socket Error 10060) [CVADHELP-18137]

  • When you try to redirect a webcam using Citrix Workspace app for Windows that is installed on a VDA, the webcam might fail. [HDX-28691]

  • If you’re sharing your screen in Microsoft Teams with HDX optimization on a multi-monitor setup, the screen sharing picker fails to capture individual monitors. This issue occurs when the virtual desktop isn’t using the Desktop Viewer toolbar or it is using Desktop Lock. Instead of individual monitor, all the monitors are condensed into a single composite image. You might see this issue on the Citrix Workspace app for Windows 2106 or later. With this release, multi-monitor screen sharing functionality is disabled:

  • if the Desktop Viewer is disabled in StoreFront or in the ICA file, or
  • if the Desktop Lock is in use. Only the primary monitor can be shared. [HDX-34200]

To know the existing issues within the product, see Known issues.

2108

What’s new

Revamped Add Account Screen

This release introduces a revamped Add Account screen.

Revamped add account screen

Inactivity Timeout for Citrix Workspace sessions

Admins can configure the inactivity timeout value. The inactivity timeout value specifies the amount of idle time that is allowed before the user automatically signs out of the Citrix Workspace session. If there is no activity from the mouse, keyboard, or touch for the specified interval of time, Citrix Workspace app automatically sign-out. The inactivity timeout does not affect the already running virtual apps and desktops sessions or the Citrix StoreFront stores.

For more information see Inactivity Timeout for Workspace Sessions

Note:

Admins can configure the inactivity timeout only for Workspace (cloud) sessions.

Support for custom web stores [Technical preview]

With this release, you can access your organization’s custom web store from the Citrix Workspace app for Windows. To use this feature, the admin must add the domain or the custom web store to the allowed URLs list in the Global App Configuration Service. When you add, you can provide the custom web store URL in the Add Account screen in Citrix Workspace app. The custom web store opens in the native Workspace app window.

For information about configuring custom web stores, see Custom web stores

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised not to deploy Beta builds in production environments.

StoreFront to Workspace URL Migration [Technical preview]

When your organization move from on-prem StoreFront to Workspace, end users must manually add the new Workspace URL to the Workspace app on their end points. This feature enables administrators to seamlessly migrate users from a StoreFront store to a Workspace store with minimal user interaction.

For more information about this feature, see StoreFront to Workspace URL Migration [Technical preview]

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised not to deploy Beta builds in production environments.

Fixed issues

Logon/Authentication

If a Citrix Gateway session times out, Citrix Workspace might not prompt for authentication when launching an application. [RFWIN-23829]

To know the existing issues within the product, see Known issues.

2107

What’s new

EPA enhancement

Starting with this release, Citrix Workspace app can download and install the EPA plug-in in Workspace deployments. After the installation completes, the Advanced Endpoint Analysis (EPA) scans the device for endpoint security requirements configured on the Citrix Gateway. When the scan completes, the Citrix Workspace app login window appears.

Note:

This feature works only if you have configured nFactor authentication in your environment.

For more information on the EPA scan, see Advanced Endpoint Analysis scans.

Citrix Workspace app Beta program

Starting with this release, you can automatically update existing installations of Citrix Workspace app to the most recent beta builds and test them. Beta builds are early access versions released before the general availability of a fully supported stable release update. You receive an update notification when the Citrix Workspace app is configured for automatic updates.

To update to beta builds select the Beta channel from the drop-down menu in the Update Settings window:

  • Release - Fully supported stable release update
  • Beta - Early access release to easily test and report issues before general availability

Update channels

Note:

Beta builds are available for customers to test in their non-production or limited production environments, and share feedback. Citrix does not accept support cases for beta builds but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised not to deploy Beta builds in production environments.

For more information about installing auto-update channels, see Installing Citrix Workspace app Beta program.

Support for the following authentication mechanisms [Technical preview]

Starting with this release, you can authenticate to the Citrix Workspace app using the following mechanisms:

  • Windows Hello and FIDO2 Security Keys based authentication
  • Single Sign-On (SSO) to Citrix Workspace app from Microsoft Azure Active Directory (AAD) joined machines with AAD as identity provider

System requirements

Microsoft Edge WebView2 Runtime version 92 or later.

Note:

Starting with Version 2107, Microsoft Edge WebView2 Runtime installer is packaged with the Citrix Workspace app installer. During Workspace app installation, the installer checks whether the Microsoft Edge WebView2 Runtime is present on the system and installs it if not found.

If you are trying to install Citrix Workspace app as a non-administrator and Microsoft Edge WebView2 Runtime isn’t present, the installation stops with the following message:

You must be logged on as an administrator to install the following prerequisite package(s):

Edge Webview2 Runtime

This feature is supported only on Workspace (Cloud) deployments.

Enabling the authentication mechanisms

To enable the authentication mechanisms, admins must perform the following steps:

  1. Launch the registry editor.

  2. Navigate to the following registry path:

    • As an administrator:

      • For 64-bit operating systems: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\Dazzle

      • For 32-bit operating systems: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Dazzle

    • As a non-administrator:

      • For 64-bit or 32-bit operating systems: \HKEY_CURRENT_USER\SOFTWARE\Citrix\Dazzle
  3. Create a registry key with the following attributes:

    Registry key name: EdgeChromiumEnabled

    Type: String Value

    Value: True

  4. Restart the Citrix Workspace app for the changes to take effect.

Note:

Technical previews are available for customers to use in their non-production or limited production environments, and share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance.

Support for Conditional access with Azure AD [Technical preview]

With this release, you can authenticate using conditional access if your admin configures the policies.

System requirements

Microsoft Edge WebView2 Runtime version 92 or later.

Note:

Starting with Version 2107, Microsoft Edge WebView2 Runtime installer is packaged with the Citrix Workspace app installer. During Workspace app installation, the installer checks whether the Microsoft Edge WebView2 Runtime is present on the system and installs it if not found.

Enabling authentication using conditional access

To enable authentication using conditional access with Azure AD, admins must perform the following steps:

  1. Launch the registry editor.

  2. Navigate to the following registry path:

    • For 64-bit operating systems: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\Dazzle

    • For 32-bit operating systems: Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Dazzle

  3. Create a registry key with the following attributes:

    Registry key name: EdgeChromiumEnabled

    Type: String Value

    Value: True

  4. Restart the Citrix Workspace app for the changes to take effect.

Support for Local App Discovery within the Workspace App [Technical Preview]

Starting with Version 2107, admins can configure the discovery and enumeration of locally installed applications within the Citrix Workspace app. You can configure this feature by using the Global App Configuration Service. For more information about configuring this feature, see Global App Configuration Service.

This feature is ideal for devices that runs in the kiosk mode and for the applications that can’t be virtualized within the Citrix Workspace.

Note:

Technical previews are available for customers to use in their non-production or limited production environments, and share feedback. Citrix does not accept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance.

Fixed issues

Keyboard

With app protection installed, keyboard inputs might not be compatible with some HP G5 series laptops. [RFWIN-24103]

Session/Connection

  • With the drag and drop featured enabled, attempts to resize a published application might fail. [CVADHELP-17089]

  • When configuring the client and VDA with network proxy settings, the browser content redirection might fail on the Chrome browser. [CVADHELP-17430]

  • With single sign-on, when you sign in with a UPN credential and then change the password on the endpoint, the following error message might appear after you attempt to launch a session:

    The user name or password is incorrect. Try again. [CVADHELP-17620]

  • When you initiate a video call during a Microsoft Teams meeting, the Desktop Viewer might become unresponsive. [HDX-32435]

To know the existing issues within the product, see Known issues.

2106

What’s new

Global App Config Service

The new Global App Configuration Service for Citrix Workspace allows a Citrix administrator to deliver Workspace service URLs and Workspace App settings through a centrally managed service.

For more information, see Global App Configuration Service documentation.

Option to disable storing of authentication tokens through Global App Config Service

Citrix Workspace app now provides an extra option to disable the storing of authentication tokens on the local disk. Along with the existing Group Policy Object (GPO) configuration, you can also disable the storing of authentication tokens on the local disk using the Global App Configuration Service.

In the Global App Configuration Service, set the Store Authentication Tokens attribute to False.

For more information, see the Global App Configuration Service documentation.

Service continuity

Service continuity removes or minimizes the dependency on the availability of components that are involved in the connection process. Users can launch their virtual apps and desktops regardless of the health status of the cloud services.

For more information, see Service continuity section in the Citrix Workspace documentation.

Microsoft Teams enhancements

When Desktop Viewer is in full screen mode, the user can select one from all screens covered by the Desktop Viewer to share. In window mode, the user can share the Desktop Viewer window. In seamless mode, the user can select one from all screens to share. When the Desktop Viewer changes the window mode (maximized, restore, or minimize), the screen share stops.

Bi-directional URL support with Chromium-based browsers

Bidirectional content redirection allows you to configure URLs to redirect from client to server and from server to client. You can configure this using policies on the server and the client.

Using the Group Policy Object (GPO) administrative template, you can set server policies on the Delivery Controller and client policies on Citrix Workspace app.

With this release, bidirectional URL redirection support has been added for Google Chrome and Microsoft Edge.

Prerequisites:

  • Citrix Virtual Apps and Desktops Version 2106 or later.
  • Browser redirection extension version 5.0.

To register Google Chrome browser to bidirectional URL redirection, run the following command from the Citrix Workspace app installation folder:

%ProgramFiles(x86)%\Citrix\ICA Client\redirector.exe /regChrome /verbose

To unregister Google Chrome browser from bidirectional URL redirection, run the following command from the Citrix Workspace app installation folder:

%ProgramFiles(x86)%\Citrix\ICA Client\redirector.exe  /unregChrome /verbose

For information on configuring URL redirection on Citrix Workspace app, see Bidirectional content redirection.

For more information about browser content redirection, see Browser content redirection in the Citrix Virtual Apps and Desktops documentation.

Improved ICA file security - Technical Preview

In earlier releases, the ICA file downloads to the local disk when you launch a virtual apps and desktops session.

With this release, we provide enhanced security in the way Citrix Workspace app handles ICA files during a virtual apps and desktops session launch.

Citrix Workspace app now lets you store the ICA file in the system memory instead of the local disk. This feature aims to eliminate surface attacks and any malware that might misuse the ICA file when stored locally. This feature is also applicable on virtual apps and desktops sessions that are launched on workspace for Web.

For more information, see Improved ICA file security section.

To provide feedback on this feature, use the Podio form.

Fixed issues

Session/Connection

  • Attempting to print a file using the Citrix PDF printer might fail when using Google Chrome, Mozilla Firefox, or Microsoft Internet Explorer as the default PDF viewer. [CVADHELP-16662]
  • After upgrading Citrix Workspace app for Windows to version 1912 LTSR CU1 or CU2, session reliability might fail. The issue occurs when the Enlightened Data Transport (EDT) protocol is set, and the connection is through Citrix Gateway. [CVADHELP-16694]
  • Attempts to launch applications using Citrix Workspace app for Windows might fail when the VPN is connected or disconnected. [CVADHELP-16714]
  • In double-hop scenarios, endpoint client names might not pass through to the Delivery Controller or Director. The issue occurs with VDA Version 2003 and later. [CVADHELP-16783]
  • Setting the CurrentAccount value to AllAccount under the registry HKEY_LOCAL_MACHINE\Software\Citrix\Dazzle might not take effect. The issue occurs when one or more store accounts are present. [CVADHELP-17229]
  • Attempts to log on to Citrix Workspace app for Windows might fail when the user name contains umlaut characters. [CVADHELP-17267]
  • Attempts to download a file hosted on an on-premises network, might fail. [CVADHELP-17337]
  • During a conference call, when using Microsoft Teams in HDX optimized mode, the video portion of incoming calls might flicker. [CVADHELP-17398]
  • Attempting to download a file using the Microapps might fail. [CVADHELP-17438]

User Interface

  • When you use the Chinese or Japanese Input Method Editor (IME) to input text in a text box, the text might appear outside of the text box in the top-left corner of the screen. [CVADHELP-15614]
  • When you try to launch an application from a shortcut, the shortcut icon might flash on some desktops. This issue occurs after you upgrade Citrix Receiver version 4.9.6 for Windows to Citrix Workspace app. [CVADHELP-16967]
  • Attempts to run the Beacon Checker test on ping.citrix.com might fail. [RFWIN-22672]

  • Service continuity might not support all users who have Unicode user names on their Windows devices but ASCII user names for their Citrix Workspace account. If the Unicode user name contains Cyrillic or eastern Asian characters, Workspace connection leases fail to launch for these users. [RFWIN-23040, RFWIN-23046]

To know the existing issues within the product, see Known issues.

2105

What’s new

Support for customized URLs through 301 redirects

Citrix Workspace app now allows you to add URLs that redirect to Citrix Workspace from StoreFront or Citrix Gateway through HTTP 301 redirects.

If you’re migrating from StoreFront to Citrix Workspace, you can redirect the StoreFront URL to a Citrix Workspace URL through an HTTP 301 redirect. As a result, when adding an old StoreFront URL, you’re automatically redirected to Citrix Workspace.

Example of a redirect:

The StoreFront URL https://< Citrix Storefront url>/Citrix/Roaming/Accounts can be redirected to a Citrix Workspace URL: https://<Citrix Workspace url>/Citrix/Roaming/Accounts.

Microsoft Teams enhancement

  • You can now configure a preferred network interface for media traffic.

    Navigate to \HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXMediaStream and create a key called NetworkPreference(REG_DWORD).

    Select one of the following values as required:

    • 1: Ethernet
    • 2: Wi-Fi
    • 3: Cellular
    • 5: Loopback
    • 6: Any

    By default and if no value is set, the WebRTC media engine chooses the best available route.

  • You can now disable the audio device module 2 (ADM2) so that the legacy audio device module (ADM) is used for quad-channel microphones. Disabling the ADM2 helps to resolve issues related to microphones in a call.

    To disable ADM2, navigate to \HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXMediaStream and create a key named DisableADM2 (REG_DWORD) and set the value to 1.

To know the existing issues within the product, see Known issues.

Fixed issues

Session/Connection

  • When using Citrix Workspace app for Windows, app protected resources might fail to launch and remain stuck on the connecting screen. The issue occurs with Citrix Workspace app installed on server operating systems, such as Windows Server 2019. [RFWIN-22120]
  • Attempts to run commands on Git bash might fail. The issue occurs with Citrix Workspace app that has the app protection feature enabled. [RFWIN-22187]
  • After installing the latest version of Citrix Workspace app, you might get a prompt to upgrade when you log on StoreFront. [RFWIN-22419]
  • Attempts to exit Citrix Workspace app might fail. The issue occurs when the user credentials prompt appears repeatedly. [RFWIN-22491]
  • After creating a desktop shortcut for an app and restarting the client device, the first attempt to launch the app from the shortcut might fail. The issue occurs when you do not specify the storedescription when installing Citrix Workspace app using the command-line interface. [RFWIN-22510]
  • When you download a file from Citrix Files, some non-English file names might appear garbled. [RFWIN-22516]
  • With hardware-enforced stack protection enabled and the HSP or CET features supported, applications might exit unexpectedly on 11 Generation Intel Core processors and AMD Ryzen 5000 series processors. [RFWIN-22592]
  • If the HDX Adaptive Transport policy is set to Preferred and EDT MTU Discovery is enabled, when you try to launch applications or desktops, a gray or a black screen might appear with a warning message. [RFWIN-22697]
  • Citrix Workspace app for Windows might fail to enumerate applications and remain stuck on a gray screen. The issue is specific to the Intel Iris Xe Graphics card. [RFWIN-22952]
  • During Microsoft Teams peer-to-peer video calls, the HdxRtcEngine.exe process might become unresponsive. The issue occurs in multi-monitor setups with different screen resolutions. [HDX-28616]
  • When you join a Microsoft Teams meeting from Outlook, the incoming video might not work. The issue occurs when you join the meeting without launching Microsoft Teams. [HDX-29558]
  • During Microsoft Teams meetings, when you hover the mouse pointer over the video, the video might flicker. [HDX-29668]

System Exceptions

  • The Wfica32.exe process might exit unexpectedly because of the faulting module, gfxrender.dll. [RFWIN-22446]

Security issues

  • On an admin-installed instance of Citrix Workspace app, users with non-admin privileges might be able to escalate privileges level. For more information, see Citrix Knowledge Center article CTX307794.

To know the existing issues within the product, see Known issues.

2103.1

What’s new

Enhancement to keyboard layout configuration

The keyboard layout configuration now includes a Don’t sync option. The option is available for both the Group Policy Object (GPO) policy and the GUI configurations.

When you select the Don’t sync option, the server keyboard layout is used in the session and the client keyboard layout is not synced to the server keyboard layout.

For more information, see Keyboard layout and language bar.

Option to disable storing of authentication tokens

Authentication tokens are encrypted and stored on the local disk so that you don’t need to reenter your credentials when your system or session restarts.

Citrix Workspace app introduces an option to disable the storing of authentication tokens on the local disk. For enhanced security, we now provide a Group Policy Object (GPO) policy to configure the authentication token storage.

Note:

This configuration is applicable only in cloud deployments.

For more information, see Authentication tokens.

Microsoft Teams enhancements

  • The VP9 video codec is now disabled by default.
  • Enhancement to echo cancellation, auto gain control, noise suppression configurations: If Microsoft Teams configures these options, Citrix-redirected Microsoft Teams honors the values as configured. Otherwise, these options are set to True by default.
  • DirectWShow is now the default renderer.

    To change the default renderer, do the following:

    • Launch the Registry editor.
    • Navigate to the following key location: HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXMediaStream.
    • Update the following value: "UseDirectShowRendererAsPrimary"=dword:00000000

      Other possible values:

      • 0: Media Foundation
      • 1: DirectShow (Default)
    • Relaunch the Citrix Workspace app.

Fixed issues

Logon/Authentication

  • Even after you enable the keep me signed in and don’t ask again for 60 days policies, Microsoft Azure Multi-Factor Authentication might still prompt for authentication.

    Note:

    We recommend that users exit their stores rather than log off from their stores. If users log off from stores using webview authentication, they might be prompted for authentication again because Internet Explorer cookies are cleared in such scenarios. By default, the fix is enabled (cookies are stored). You can disable the fix by using the GPO option. If you disable the fix, the cookies are not stored and are cleared during logoff.

    [CVADHELP-14814]

  • On Azure Active Directory (AD) joined devices, when Citrix Workspace app attempts to access a store and then passes through endpoint login credentials, you might not be able to authorize to log in. Also, there is no option to log on with a different user account. [CVADHELP-14844]

Security issues

  • This fix improves security in an underlying component. [RFWIN-20912]

Session/Connection

  • When you launch a published desktop through a native Citrix Workspace app for Windows, the native Citrix Workspace app automatically runs in the foreground within the desktop. The issue occurs when the Local App Access feature enabled. [CVADHELP-15654]
  • In scenarios where proxy servers do not use port 8080, Citrix Workspace app might fail to connect to published applications and desktops. The issue occurs when Citrix Workspace app for Windows fails to use the proxy port and use the default port 8080 instead. [CVADHELP-15977]
  • Citrix Workspace app for Windows might ignore proxy type settings. The issue occurs with non-English versions of the Microsoft Windows operating system. [CVADHELP-16017]
  • When you press ALT + Tab key in a user session, a new, blank window of Citrix Workspace app for Windows might open. [CVADHELP-16379]
  • The Print Screen key might not capture screenshots even if/when the protected windows are minimized. [RFWIN-16777]
  • If you are using a webcam or a video in a Microsoft Teams call, the HDXrtcengine.exe might turn unresponsive. For a workaround, see Knowledge Center article CTX296639. [HDX-29122]
  • When you attempt to compose DBCS text using IME, underlines might be missing. The issue occurs with Windows 10 2004 operating systems. [RFWIN-20006]
  • Incorrectly set permissions on the C:\ProgramData\Citrix folder might cause Citrix Workspace app to exit unexpectedly. [RFWIN-22753]
  • During a Microsoft Teams video call, the LED on camera might flash and the preview video might stop. [CVADHELP-16383]

User Interface

  • Citrix Workspace app for Windows might not close when you click the Exit option once. As a workaround, select the Exit option twice for the Workspace app to close. [RFWIN-21518]

To know the existing issues within the product, see Known issues.

2102

What’s new

Proxy authentication support

Previously, on client machines configured with proxy authentication, if the proxy credentials don’t exist in the Windows Credential Manager, you aren’t allowed to authenticate to Citrix Workspace app.

Now, on client machines configured for proxy authentication, if the proxy credentials aren’t stored in the Windows Credential Manager, an authentication prompt appears, asking you to enter the proxy credentials. Citrix Workspace app then saves the proxy server credentials in Windows Credential Manager. This results in a seamless login experience because you don’t need to manually save your credentials in Windows Credential Manager before accessing Citrix Workspace app.

Microsoft Teams enhancements

  • Improved video rendering.
  • Performance and reliability improvements.

Fixed issues

Session/Connection

  • When you attempt to open an application from Favorites on a published desktop using Citrix Workspace app with the vPrefer option enabled, the application might open with a spinning circle. If the spinning circle remains, you cannot open the application again. [CVADHELP-13237]
  • With the vPrefer option enabled, App-V applications might start on a remote server rather than on a local server. [CVADHELP-15356]
  • The StoreBrowse.exe command might fail to display the complete list of published applications when the application names are provided in the Chinese traditional or Japanese languages. [CVADHELP-15952]
  • When the EnableFactoryReset registry setting is set to False, attempts to uninstall Citrix Workspace app might fail with this error message:

    This feature has been disabled.

    [CVADHELP-16114]

  • The log collection feature might fail to collect the CDF trace. [CVADHELP-16587]

System Exceptions

  • The Receiver.exe process might exit unexpectedly. [CVADHELP-15669]

User Interface

  • When you use the Chinese or Japanese Input Method Editor (IME) to input text in a text box, the text might appear outside of the text box in the top-left corner of the screen. [CVADHELP-15614]

To know the existing issues within the product, see Known issues.

2012.1

What’s new

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

Fixed issues

  • Automatic update of Citrix Workspace app from Version 2012 to a later version fails with the following error message:

    “Could not load file or assemble Newtonsoft.Json”

    The issue occurs only when automatic update is enabled on an admin-installed instance of the Citrix Workspace app.

    As a workaround, download Citrix Workspace app Version 2012.1 or later from the Citrix Downloads page and install it manually.

    [RFWIN-21715]

To know the existing issues within the product, see Known issues.

2012

What’s new

Support for Italian language

Citrix Workspace app for Windows is now available in the Italian language.

Log collection

Log collection simplifies the process of collecting logs for Citrix Workspace app. The logs help Citrix to troubleshoot, and, in cases of complicated issues, facilitate support.

You can now collect logs using the GUI.

For more information, see Log collection.

Support for the domain pass-through authentication on Citrix Workspace

This release introduces support for the domain pass-through authentication on Citrix Workspace, along with the existing support for StoreFront.

Silent authentication for Citrix Workspace

Citrix Workspace app introduces a Group Policy Object (GPO) policy to enable silent authentication for Citrix Workspace. This policy enables Citrix Workspace app to log in to Citrix Workspace automatically at system startup. Use this policy only when domain pass-through (single sign-on) is configured for Citrix Workspace on domain-joined devices.

For more information, see Silent Authentication.

Enhancement to app protection configuration

Previously, the authentication manager and the Self-Service plug-in dialogs were protected by default.

This release introduces a Group Policy Object (GPO) policy that lets you configure the anti-keylogging and anti-screen-capturing functionalities separately for both the authentication manager and Self-Service plug-in interfaces.

Note:

This GPO policy is not applicable for ICA and SaaS sessions. ICA and SaaS sessions continue to be controlled using the Delivery Controller and Citrix Gateway Service.

For more information, see Enhancement to app protection configuration.

Microsoft Teams enhancements

  • Peers can now see the presenter’s mouse pointer in a screen sharing session.
  • The WebRTC media engine now honors the proxy server configured on the client device.

Fixed issues

Installing, Uninstalling, Upgrading

  • When you attempt to refresh Citrix Workspace app by using its shortcut that is created manually, the shortcut might get deleted and then recreated. [CVADHELP-15397]

Session/Connection

  • In a multi-monitor environment, attempts to maximize a user session might fail. The issue occurs when you redock your laptop. [CVADHELP-13614]
  • A security warning dialog might appear when you do one of the following:
    • Retrieve an ICA file from StoreFront by using the Storebrowse command.
    • Launch an application by using an ICA file rather than from a browser.

    [CVADHELP-15221]

  • In a double-hop scenario, attempts to launch an application using the shortcut in the Start menu might fail. The issue occurs if you enable the one-instance-per-user application limit. [CVADHELP-15576]
  • You configure Citrix Workspace app for Windows to connect to all store accounts when establishing a session. If you log off from Citrix Workspace app and log back on, the store account setting changes to one store account rather than defaulting to all accounts. [CVADHELP-15728]
  • Attempts to share your screen in a Microsoft Teams call might result in a black screen. [HDX-27041]
  • In Microsoft Teams calls, the audio might be choppy. The issue occurs when the UDP traffic port is disabled. [HDX-27914]

User Experience

  • Attempts to launch a session might fail after you do a fresh installation of Citrix Workspace app for Windows or upgrade an existing installation to the latest. The session launch is stuck on the Preparing your desktop screen. The issue occurs when you configure Desktop Lock by using a Citrix Gateway URL.

    Note:

    A black screen appears for some time before Desktop Lock appears the first time you configure Citrix Workspace app for Windows by using a Citrix Gateway URL and Desktop Lock. If the black screen remains for a long time, sign out by using Ctrl+Alt+Delete for physical machines and Ctrl+Alt+End for virtual machines.

    [CVADHELP-15334]

  • With High DPI set to Yes or No, when you launch a desktop session, some elements in the CD Viewer toolbar might not scale up to match the current DPI setting of the device. The issue occurs when the DPI setting of the user device is greater than 100%. [CVADHELP-15418]
  • After you upgrade Citrix Workspace app to Version 1912 CU1 from Version 1912, application enumeration might be slow, taking about 10 minutes to complete. [CVADHELP-15766]

To know the existing issues within the product, see Known issues.

2010

What’s new

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

Fixed issues

Keyboard

  • When you use a Japanese language keyboard, Full-width input mode might fail to work with Microsoft Excel launched on the local device. The issue occurs when the app protection feature is enabled. [CVADHELP-15410]

Session/Connection

  • Attempts to launch applications might fail after you upgrade Citrix Workspace app for Windows from version 2006 to version 2008 or later. The issue occurs with machines running non-English (such as Swedish) number formats. [CVADHELP-15988]
  • When you enable the app protection feature, the Pause/Break and Num Lock keys might be mapped incorrectly. [RFWIN-20083]
  • On Citrix Workspace app for Windows, when you add a cloud account using a store URL, this error message might appear:

    “Cannot connect to server.”

    The issue occurs when the URL contains an uppercase letter.

    [RFWIN-20907]

  • Microsoft Teams optimization: In a multi-monitor setup or a single monitor with high DPI, outgoing screen sharing might not function properly. The other peer might view a black window instead. [RFWIN-20854]
  • When you click Help in the notification area of Citrix Workspace app for Windows, the Help page appears in Traditional Chinese instead of English. [RFWIN-21069]

To know the existing issues within the product, see Known issues.

2009.6

What’s new

Support for FIDO2 authentication

FIDO2 authentication lets users take advantage of the local endpoint FIDO2 components. Users can now authenticate using FIDO2 security keys or integrated biometrics. Devices must have Trusted Platform Module (TPM) 2.0 and Windows Hello. For more information, see FIDO2: WebAuthn & CTAP.

Microsoft Teams enhancements

  • Microsoft Teams now displays previously used peripheral devices in the Preferred devices list.
  • The WebRTC media engine accurately determines the maximum encoding resolution possible on an endpoint. The WebRTC media engine estimates multiple times a day and not only on first launch.
  • The Citrix Workspace app installer is now packaged with the Microsoft Teams ringtones.
  • Echo cancellation improvements - Reduced echo level when a peer has a speaker or microphone that generates an echo.
  • Screen sharing improvements - Now when you share your screen, only the Desktop Viewer screen is captured in native bitmap format. Previously, client local windows that overlaid on top of the Desktop Viewer window were blacked out.

Fixed issues

  • When you connect to Citrix Workspace app using a VPN and select the Refresh apps option, the refresh action might fail. [CVADHELP-14418]
  • If you attempt to install Citrix Workspace app without configuring self-service mode, an exception might occur. The issue occurs when you open the Shortcuts and Reconnect menu from the Advanced Preferences sheet. The issue occurs with Citrix Workspace app versions 1907 through 2002. [CVADHELP-14940]
  • With the registry editing tool disabled, registry keys from the previous installation might not be preserved after you perform an upgrade. As a result, attempts to launch a desktop fail. [CVADHELP-15104]
  • Attempts to maximize the screen in a session that has a published instance of Microsoft Teams running might fail. [RFWIN-20051]
  • Desktop sessions might turn unresponsive intermittently or get disconnected. The issue occurs when you set the Audio Quality option to Medium and enable the echo cancellation feature on the Delivery Controller. [RFWIN-20557]
  • After you upgrade Citrix Workspace app, multiple Workspace app icons might appear in the notification area. [RFWIN-20589]
  • When you try to access shared folders on a network, the Windows Security authentication prompt might not appear. [RFWIN-20599]
  • In a cloud deployment, attempts to connect to a store using proxy authentication might not work. [RFWIN-20673]
  • In cloud deployments, attempts to connect to an existing store might fail with the following error message:

    “Cannot Connect to Server.”

    The issue occurs after you upgrade Citrix Workspace app. As a workaround, reset Citrix Workspace app or remove the store account and add it again. [RFWIN-20834]

To know the existing issues within the product, see Known issues.

2009

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.

To know the existing issues within the product, see Known issues.

2008

What’s new

Group Policy Object (GPO) administrative template configuration for keyboard layout and language bar

In addition to the existing GUI method, you can now configure the keyboard layout and language bar using the Group Policy Object (GPO) administrative template.

For more information, see Keyboard layout and language bar.

CryptoKit update

Citrix Workspace app now supports Version 14.2.1 of the CryptoKit.

Language support

Citrix Workspace app for Windows is now available in the Portuguese (Brazil) language.

Authentication enhancement

To provide a seamless experience, the authentication dialog now appears inside Citrix Workspace app. The Store details appear on the logon screen. Authentication tokens are encrypted and stored so that you don’t need to reenter the credentials when you reboot your system or restart the session.

Note:

This authentication enhancement is applicable only in cloud deployments.

Enhancement to app protection

Previously, when you try to take a screenshot of a protected window, the entire screen, including the non-protected apps in the background used to black out.

Now, when you are taking a screenshot using a snipping tool, only the protected window is blacked out. You can take a screenshot of the area outside the protected window.

However, if you’re using the PrtScr key to capture a screenshot on a Windows 10 device, you must minimize the protected window.

This release also addresses issues to improve the app protection feature.

Enhancement to Browser Content Redirection

  • Cookies are now persistent across the sessions: When you exit and relaunch a browser, you are not prompted to reenter your credentials.
  • Browsers now honor the local system language.

Fixed issues

Installing, Uninstalling, Upgrading

  • Attempts to use the auto-update functionality to automatically update the HDX RealTime Media Engine (RTME) along with Citrix Workspace app might fail. The RTME fails to upgrade to the latest version. [CVADHELP-15047]

Logon/Authentication

  • When you configure Citrix Gateway to support single sign-on (SSO) through the Citrix Workspace app, SSO might fail. The issue occurs when a user name or password contains special characters such as %, =, and &. [CVADHELP-14564]

Session/Connection

  • When you launch a published application from the Start menu without logging on to Citrix Workspace app, two windows might appear, and prompt you to log on to Citrix Workspace app. The issue occurs if you configure the PNA address as STORE0 using the CitrixReceiver.exe command. [CVADHELP-13916]
  • With the vPrefer option enabled in Citrix Workspace app, attempts to launch an App-V application might fail with the following error message:

    Cannot start

    [CVADHELP-14039]

  • The registry values related to the deprecated feature, HDX MediaStream for Flash, for example, Flash and Flash2 might exist in the registry setting, HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Configuration\Advanced\Modules\ICA 3.0\VirtualDriver. The deprecated feature might exist after you upgrade the Citrix Workspace app. This issue can cause a connection failure. [CVADHELP-14850]
  • When you use Citrix Workspace app, the self-service window might intermittently display a blank screen. [RFWIN-17563]

User Experience

  • When you add an account using a store URL on Citrix Workspace app for Windows, it might take a long time to complete. The issue occurs when the URL contains a port number. [CVADHELP-14051]

To know the existing issues within the product, see Known issues.

2006.1

What’s new

Enhancement to Microsoft Teams screen sharing

With this release, the contents shared using Microsoft Teams are limited to the contents of the Desktop Viewer window. Areas outside the Desktop Viewer window are cropped, and the client’s local apps that overlap the Desktop Viewer black out.

For more information, see Screen sharing.

Update to Citrix Analytics Service

Citrix Workspace app is instrumented to securely transmit data to Citrix Analytics Service from ICA sessions that you launch from a browser.

For more information on how Citrix Analytics uses this information, see, Self-Service for Performance and Self-service search for Virtual Apps and Desktops.

Fixed issues

Content redirection

  • With Browser Content Redirection (BCR) enabled, you might not be able to enter any text in input fields on a page when you refresh that page. The issue occurs with seamless sessions. [CVADHELP-12922]
  • When you attempt to redirect a long URL, the URL might not be redirected to a VDA and the Redirector.exe process exits unexpectedly with the following exception:

    INVALID_CRUNTIME_PARAMETER

    [CVADHELP-13197]

Session/Connection

  • After launching and exiting streamed media, audio becomes unavailable in the session. [CVADHELP-13297]
  • If you add two stores to Citrix Workspace app for Windows using two different accounts, the Sign-in button might not work for the secondary store after you remove the primary store. [CVADHELP-13805]
  • In a double-hop scenario, the Citrix HDX Engine might exit unexpectedly when you attempt to launch a session. [CVADHELP-13915]
  • With the multifactor authentication and Windows Security dialog being used to log in, the Active Directory Federation Services (ADFS) dialog doesn’t appear when you try to authenticate to stores. [CVADHELP-14316]
  • Attempts to take screenshots of sessions might succeed even when app protection is enabled. [RFWIN-17455]

System Exceptions

  • The wfica32.exe process might exit unexpectedly when you attempt to reconnect to a session. The issue occurs with Version 1904.1 of Citrix Workspace app for Windows. [CVADHELP-12807]

User Interface

  • An application might attempt to come to the foreground intermittently, displacing the current application. Its icon in the taskbar might flash, informing the user that the application attempts to come to the foreground. [CVADHELP-13071]
  • When you minimize an application launched through Local App Access, the application’s icon might disappear from the taskbar. [CVADHELP-13293]
  • An extra Workspace app for Windows icon might appear in the notification area. [RFWIN-17499]

To know the existing issues within the product, see Known issues.

2002

What’s new

App protection

Disclaimer

App protection policies work by filtering access to required functions of the underlying operating system (specific API calls required to capture screens or keyboard presses). App protection policies provide protection even against custom and purpose-built hacker tools. However, as operating systems evolve, new ways of capturing screens and logging keys emerge. While we continue to identify and address them, we can’t guarantee full protection in specific configurations and deployments.

App protection is an add-on feature that provides enhanced security when using Citrix Virtual Apps and Desktops and Citrix DaaS (formerly Citrix Virtual Apps and Desktops service). The feature restricts the ability of clients to be compromised by keylogging and screen capturing malware. App protection prevents exfiltration of confidential information such as user credentials and sensitive information that is displayed on the screen. The feature prevents users and attackers from taking screenshots and from using keyloggers to glean and exploit sensitive information.

Note:

Citrix recommends that you only use the native Citrix Workspace app to launch a protected session.

App protection is configured between StoreFront and the Controller using the Controller. For information about configuring app protection on the Controller, see App protection in the Citrix Virtual Apps and Desktops documentation. You can use any of the following methods to apply this configuration to Citrix Workspace app by including the app protection component:

  • GUI
  • Command-line interface

You can include the app protection component both during the Citrix Workspace app installation or on-demand installation.

Note:

  • This feature is supported only on Microsoft Windows Desktop operating systems such as Windows 10, Windows 8.1, and Windows 7.
  • This feature isn’t supported over Remote Desktop Protocol (RDP).

For information about configuring app protection in Citrix Workspace app, see App protection.

Installer enhancement

In earlier releases, if an administrator tried to install Citrix Workspace app on a system that has a user-installed instance of the app, the installation was blocked.

With this release, the administrators can now override the user-installed instance of Citrix Workspace app and continue with the installation successfully.

Enhancement to Citrix Workspace Updates

In earlier releases, if Citrix Workspace app is installed by an administrator, a non-administrator might not update it.

With this release, a non-administrator can update Citrix Workspace app on an admin-installed instance. You can do that by right-clicking the Citrix Workspace app icon in the notification area and selecting Check for Updates.

Note:

The Check for Updates option is now available on both the user-installed and the admin-installed instances of Citrix Workspace app.

Support for outbound proxy

SmartControl allows administrators to define granular policies to configure and enforce user environment attributes for Citrix Virtual Apps and Desktops and Citrix DaaS using the Citrix Gateway. For instance, you might want to prohibit users from mapping drives to their remote desktops. You can achieve this using the SmartControl feature on Citrix Gateway.

However, the scenario changes when Citrix Workspace app and Citrix Gateway belong to separate enterprise accounts. In such scenarios, the client domain can’t apply the SmartControl feature because the gateway doesn’t exist on the client domain. Instead, you can use the Outbound ICA Proxy. Outbound ICA Proxy lets you use the SmartControl feature even when Citrix Workspace app and Citrix Gateway are deployed in different organizations.

Citrix Workspace app supports session launches using the Citrix ADC LAN proxy. Either a single, static proxy can be configured or the proxy server can be selected at runtime using the outbound proxy plug-in.

You can configure outbound proxies using the following methods:

  • Static proxy: Proxy server is configured by providing a proxy host name and port number.
  • Dynamic proxy: A single proxy server can be selected among one or more proxy servers using the proxy plug-in DLL.

You can configure the outbound proxy using the Group Policy Object administrative template and the Registry editor.

For more information about outbound proxy, see Outbound ICA Proxy support in the Citrix Gateway documentation.

For more information about configuring the outbound proxy, see Outbound proxy.

Citrix Embedded Browser binaries

You can now exclude the Citrix Embedded Browser binaries to not use this feature.

This release introduces a command-line switch to exclude the Citrix Embedded Browser binaries. Run the /InstallEmbeddedBrowser=N switch from the Citrix Workspace app install location to discontinue the embedded browser feature.

You can exclude the Citrix Embedded Browser binaries only in the following cases:

  • Fresh install
  • Upgrade from a version that doesn’t include the Citrix Embedded Browser binaries.

If your version of Citrix Workspace app includes the Citrix Embedded Browser binaries and you are upgrading to Version 2002, the embedded browser binaries are automatically updated during the upgrade.

Enhancement to desktop sharing with Microsoft Teams

When you share your workspace using Microsoft Teams, Citrix Workspace app displays a red border that surrounds the area of the monitor that is currently being shared. You can share only the Desktop Viewer window, or any local window overlaid on top of it. When you minimize the Desktop Viewer window, screen sharing is paused.

Endpoint encoder performance estimator on Microsoft Teams

HdxTeams.exe is the WebRTC media engine embedded in Citrix Workspace app that handles Microsoft Teams redirection. When the HdxTeams.exe process is launched, it estimates the best encoding resolution that the endpoint’s CPU can sustain without overloading. Possible values are 240p, 360p, 720p, and 1080p.

The performance estimation process (also called webrtcapi.EndpointPerformance) runs when HdxTeams.exe initializes. The macroblock code determines the best resolution that can be achieved with a particular endpoint. The highest possible resolution is then included during the codec negotiation between the peers, or between the peer and the conference server.

For information about configuring the endpoint encoder, see Encoder performance estimator.

For information, see Optimization for Microsoft Teams in Citrix Virtual Apps and Desktops documentation.

Enhancement to Citrix Analytics Service

With this release, Citrix Workspace app is instrumented to securely transmit the public IP address of the most recent network hop to Citrix Analytics Service. This data is collected per session launch. It helps the Citrix Analytics Service to analyze whether poor performance issues are tied to specific geographic areas.

By default, the IP address logs are sent to the Citrix Analytics Service. However, you can disable this option on the Citrix Workspace app using the Registry editor.

To disable IP address log transmissions, navigate to the following registry path and set the SendPublicIPAddress key to Off.

  • On 64-bit Windows machines, navigate to: HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Citrix\Dazzle.
  • On 32-bit Windows machines, navigate to: HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\Dazzle.

Note:

  • IP address transmissions are a best-case effort. Although Citrix Workspace app transmits every IP address that it is launched on, some of the addresses might not be accurate.
  • In closed customer environments, where the endpoints are operating within an intranet, ensure that the URL https://locus.analytics.cloud.com/api/locateip is whitelisted on the endpoint.

For more information on how Performance Analytics uses this information, see Self-Service for Performance.

Fixed issues

HDX MediaStream Windows Media Redirection

  • In a multi-monitor environment, when you play an MP4 video using the Windows Media Player in a user session, the video might play correctly on the primary monitor. But, when you move the player to a different screen, a black screen might appear on the secondary or an extended monitor connected through DisplayLink using a docking station. [CVADHELP-11848]

Session/Connection

  • When you attempt to reconnect to a session from the HDX RealTime Media Engine using a fast smart card, the HDX RealTime Media Engine might exit unexpectedly. [CVADHELP-12605]
  • When published applications receive many requests to play short sounds for a short period, the wfica32.exe process might exit unexpectedly. [CVADHELP-12855]
  • After a session timeout is reached, the session might automatically log off. When you attempt to launch the session again, the session takes longer than normal to launch. The issue occurs when there’s a network disruption. [CVADHELP-13017]
  • With Local App Access and Desktop Lock enabled, when you perform the Switch user function after pressing the Ctrl+Alt+Del key, the local user session might reconnect. But, when the server session attempts to reconnect, the VDA is stuck on a white screen that displays the message connected to the desktop. The desktop never appears. [CVADHELP-13046]
  • A seamless application window might be rendered partially truncated and remain truncated until you manually resize the window. [CVADHELP-13108]
  • Workspace app now performs a check of the presence of shortcut icons every time it refreshes or starts. If an icon isn’t available, the Workspace app fetches the icon again. Doing so ensures that shortcuts appear correctly. [RFWIN-15501]
  • When attempting to enable the Bidirectional Content Redirection policy (under Computer Configuration > Administrative Templates > Classic Administrative Templates (ADM) > Citrix Components > Citrix Workspace > User experience), you are prompted to type a URL-specific entry even if you do not enable the URL-specific application or desktop overrides. [RFWIN-15867]

System Exceptions

  • The Receiver.exe process might exit unexpectedly while capturing the CDF traces. [CVADHELP-13077]

To know the existing issues within the product, see Known issues.

1911

What’s new

Workspace with intelligence

This version of Citrix Workspace app for Windows is optimized to take advantage of the Workspace intelligence features when they’re released. For more information, see Workspace Intelligence Features - Microapps.

Support for automatically enrolling Windows 10 devices in Citrix Endpoint Management

Note:

The auto-enroll feature is in Technical Preview. Citrix recommends using technical preview features only in test environments.

Citrix Workspace app now allows Windows 10 devices to automatically enroll in Endpoint Management.

Note:

  • This feature is supported only on Windows 10 devices.
  • This feature is applicable only on cloud deployments.

Fixed issues

Content Redirection

  • With the bidirectional content redirection policy enabled, Internet Explorer running on a user device might appear on the user’s taskbar. Also, the Internet Explorer browser window doesn’t appear in the foreground. [LD1924]

Installing, Uninstalling, Upgrading

  • With the Citrix HDX RealTime Media Engine plug-in installed, you cannot start a session after you upgrade Citrix Receiver for Windows to Version 4.9 LTSR Cumulative Update. [LD1814]

Seamless Windows

  • When you open a new window within a published application, the icon of the published application might disappear from the taskbar. [LD1868]

Session/Connection

  • With Local App Access or Desktop Lock enabled, attempts to launch a session might fail. The Citrix logon screen displays the message please wait along with the Logoff and Disconnect buttons. Also, the screen flickers for a few seconds and then the flickering stops, but the please wait message remains there.[LD1124]

  • The original client machine resolution might be unexpectedly applied to a user session after Automatic Client Reconnection (ACR) completes the session reconnection after a network outage. The issue occurs when the DPI isn’t set to 100% on the user device and when you select Yes on the Workspace app for Windows > Advanced Preferences > High DPI page. [LD1423]
  • With the Vprefer option enabled in Citrix Workspace app, published applications might launch locally, but you might experience the following two issues:
    • The system environment is not expanded. For example, %computername% as a command-line parameter is not expanded at the local client to PC12345. System environment variables do not expand. For example, %computername% as a command-line parameter does not expand to PC12345 on the local client machine.
    • Command-line parameters are not passed back to the client. For example, when using selfservice.exe -qlaunch IE11 http://www.citrix.com, the command-line parameter is passed as “Iexplore.exe %*” instead of being passed back to the client.

      [LD1450]

  • When you attempt to reconnect to a session from the HDX RealTime Media Engine using a fast smart card, the HDX RealTime Media Engine might exit unexpectedly. [LD1655]
  • When using Citrix Workspace app for Windows, if you minimize, maximize, or resize a desktop, a gray screen might overlap the desktop. [LD1656]
  • The Plantronics Blackwire 320 USB headset might disappear from the device list of Citrix Preferences when it is connected to a USB 2.0 port. The issue occurs when you repeatedly switch between the optimized and generic modes. [LD1864]
  • In double-hop scenarios where VDAs for Desktop OS are running in the first hop and published applications are running in the second hop, this error message might appear:

    Citrix HDX Engine has stopped working. Exception caused the program to stop working correctly. Please close the program.

    The issue occurs when you use third-party applications with a custom virtual channel and reconnect or seize the first hop desktop from a different client device.

    [LD1898]

  • Certain third-party applications might fail to work as seamless applications as expected. The issue occurs when window styles (for example, WS_DISABLED) aren’t applied correctly. [LD1912]

  • With Local App Access enabled, the following issues might occur when you launch a locally installed third-party application within a published desktop:
    • With Desktop Lock enabled, the application might maximize and minimize to the top-right corner of the screen. You can restore the application by clicking the application icon in the task bar.
    • With Desktop Lock disabled, a secondary window, such as the small authentication dialog window, must be in focus. But, the main window is always on top, and the secondary window is hidden behind the main window. The secondary window does not come into focus until you set the desktop to window mode.

      [LD1979]

  • A seamless application window might be rendered partially truncated and remain truncated until you manually resize the window. [LD2124]
  • With the SelfServiceMode flag set to false, when you disable an application in Citrix Studio, the application shortcut might still appear in the Start menu. [LD2126]

System Exceptions

  • With Driver Verifier enabled for CtxUsbm.sys, a memory leak in CtxUsbm.sys can result in a blue screen. Also, the development tool, Driver Verifier, must not be used in the production environment. [LD1973]

To know the existing issues within the product, see Known issues.

1909

What’s new

New installer switch

This release introduces a new installer switch called /forceinstall.

Use this switch to clean up any existing configuration and registry entries of Citrix Workspace app on the system when:

  • You’re upgrading from an unsupported version of Citrix Workspace app.
  • The installation or upgrade is unsuccessful.

Note:

The /forceinstall switch is the replacement for /rcu switch.

For more information, see Common parameters in the Install section.

Fixed issues

Session/Connection

  • In double-hop scenarios where VDAs for Desktop OS are running in the first hop and published applications are running in the second hop, this error message might appear:

    Citrix HDX Engine has stopped working. Exception caused the program to stop working correctly. Please close the program.

    The issue occurs when you use third-party applications with a custom virtual channel and reconnect or seize the first hop desktop from a different client device. [LD0479]

  • You reduce the monitor number from three to two by closing one monitor and then minimize and maximize the applications. Two white screens might appear. The issue occurs when the resolution of the laptop is different from the resolution of the others. Also, the issue occurs when you dock or undock your laptop. [LD1558]

  • Attempts to copy text from a published application to an endpoint might fail when using Citrix Workspace app 1902 for Windows or later. [LD1972]

  • When using the HDX Optimization for Microsoft Teams, when User1 starts a video call with User2 and then shares the desktop, User2 might view video artifacts instead of a shared desktop. [RFWIN-11863]

  • When using the HDX Optimization for Microsoft Teams, when User1 starts a video call with User2, both users can hear and see each other. But, when User1 starts sharing the desktop with User2, User2 might see a gray screen instead of a shared desktop. The issue occurs when the call is established on AMD clients. [RFWIN-11866]

  • When User1 starts a video call with User2 and then adds User3 to the video call, the video screen might become black for User1. This issue occurs when using the HDX Optimization for Microsoft Teams. As a result, the video screen displays as black for all the users. [RFWIN-11875]

  • When using the HDX Optimization for Microsoft Teams, when User1 starts a video call with User2 from a published instance of an application and then shares the desktop, User2 might view only a black screen instead of User1’s screen. [RFWIN-11952]
  • In the registry path HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Citrix\ICA Client\Engine\Lockdown Profiles\All Regions\Lockdown\Client Engine\HotKeys, when the DWORD value of the EnableCtrlAltEnd attribute is set to 1, published desktops can’t be launched. [RFWIN-12091]

  • When using the HDX Optimization for Microsoft Teams, the display window for the Desktop Viewer might become unresponsive during a meeting or a call. This issue continues to occur until you kill the HDXTeams.exe process. [RFWIN-15231]

User Experience

  • When you hover the mouse pointer over an application icon while several applications are running, the taskbar preview might show only the active window’s content. Note: With the client rendered Flash or Windows Media Redirection, the taskbar preview might not display correctly. [LD1030]
  • Application enumeration and filtering based on client names might not work in native Citrix Receiver with the unified experience. [LD1427]
  • When you launch a VDI desktop from Internet Explorer and move your mouse pointer toward the VDI desktop window, the VDI desktop frame might lose the focus and the mouse pointer hides behind the frame. [LD1486]

To know the existing issues within the product, see Known issues.

Known issues

Known issues in 2204.1

  • Citrix Workspace app for Windows installation in offline mode might fail when installer can’t find Microsoft Edge WebView2 on your system.

    As a workaround, install MicrosoftEdgeWebView2RuntimeInstallerX86.exe as an administrator and then try to install Citrix Workspace app for Windows.

    [RFWIN-26329]

  • Battery status notification and automatic keyboard pop-up dialog might not appear during the session when Automatic keyboard display policy is enabled on the DDC. [HDX-39558]

Known issues in 2202

  • Fresh install or update operation of Citrix Workspace app might result in delay for about 10–30 mins. For more information, see Citrix Knowledge Center article CTX335639. [RFWIN-25752]

Known issues in 2112.1

  • The Print Screen key might not capture screenshots when Citrix Workspace app for Windows with App Protection enabled starts in the background. [RFWIN-25835]
  • Fresh install or update operation of Citrix Workspace app might result in delay for about 10–30 mins. For more information, see Citrix Knowledge Center article CTX335639. [RFWIN-25752]
  • Sign out from Citrix Workspace app for Windows might not succeed when proxy authentication is enabled. [RFWIN-24813]
  • If you are using Citrix Workspace app on Microsoft Windows 11 machines, Activity Feed and Actions tabs might be missing. [WSP-13311]
  • While using the Citrix Workspace Browser, you can’t take screenshots of unprotected URL windows even when protected windows are minimized. [CTXBR-1925]
  • If you have enabled Browser Content Redirection, you cannot sign into Google Meet. [HDX-34649] As a workaround:
    1. Ensure that https://www.youtube.com/* is available in the Access Control List.
    2. Ensure that https://accounts.google.com/* is in the authentication sites list.
    3. Sign in to your Google account on any intermediary Google site, for example, YouTube.
    4. From the same instance of Google Chrome, launch Google Meet.
  • In Citrix Workspace app 2112.1, you might experience high CPU utilization on endpoint when webcam is turned on in an optimized Microsoft Teams video call. As a workaround, create the following registry key on your endpoint:

    Computer\HKEY_CURRENT_USER\SOFTWARE\Citrix\HDXMediaStream Name: UseDefaultCameraConfig Type: REG_DWORD Value: 0

    [HDX-37168]

  • In Citrix Workspace app, you might experience intermittent failures when answering or making a Microsoft Teams call. The following error message appears:

    Call could not be established.

    As a workaround, try to re-establish the Microsoft Teams call.

    [HDX-38819]

Known issues in 2109.1

No new issues have been observed in this release.

Known issues in 2109

If you’ve installed the Workspace app with a version earlier than 2109 as a user and the admin installs version 21.0.9, the Entry point not found error message appears if you log back into the device as a user. When you click OK, the message disappears and the Workspace app is updated to version 21.0.9. [RFWIN-25008]

If your admin has installed external extensions in Google Chrome, the Citrix Workspace Browser crashes when you open it. [CTXBR-2135]

Known issues in 2108

Sessions fail to launch in the offline mode (Service continuity) on client machines, when the user name has Cyrillic or in east Asian characters. [RFWIN-23906]

Known issues in 2107

No new issues have been observed in this release.

Known issues in 2106

  • On stores where the Service Continuity feature is enabled, you might not be able to launch resources. The issue occurs with Unicode users. [RFWIN-23439]
  • Attempt to redirect a webcam using Citrix Workspace app for Windows that is installed on a VDA, the webcam might fail. [HDX-28691]

Known issues in 2105

  • During a session, when you click Check for Updates and updates are downloaded successfully, current sessions are not listed in the Download successful dialog. [RFWIN-23152]

Known issues in 2103.1

  • The Self-Service plug-in window is blank and no apps are displayed at session launch. The issue occurs when using the Intel Xe Graphics card and due to limitation from the third-party. [CVADHELP-17005]
  • Attempts to compose characters in Japanese, Chinese, or Korean IME might not work properly. The composition window appears misplaced and is not seamless. This issue doesn’t occur when using virtual apps and desktops sessions and SaaS apps. [RFWIN-21158]
  • Attempts to exit Citrix Workspace app might fail. The issue occurs when the user credentials prompt appears repeatedly. [RFWIN-22491]
  • After creating a desktop shortcut for an app and restarting the client device, the first attempt to launch the app from the shortcut might fail. The issue occurs when you do not specify the storedescription when installing Citrix Workspace app using the command-line interface. [RFWIN-22510]
  • When you download a .txt file from Citrix Files, the Japanese file name can appear garbled. [RFWIN-22516]
  • When you try a peer-to-peer call with Microsoft Teams HDX optimization, calls might fail. This issue occurs if the VDA version is 2103 or lower and the Workspace app for Windows is 2103 or higher. This issue is fixed in Virtual Delivery Agent (VDA) 2106.

Known issues in 2102

  • Attempts to launch an ICA session might fail. The issue occurs when the proxy server uses port 8080 instead of a custom port. [CVADHELP-15977]
  • In an application session, when you open an image to scan in Microsoft Paint, both the Microsoft Paint application and the scanning process might become unresponsive. The issue occurs when you launch the session in windowed mode. [RFWIN-21413]
  • On machines configured for Azure Active Directory Multifactor Authentication (MFA), the login prompt appears even when the Keep me signed in and Don’t ask again for 60 days options are selected. [RFWIN-21623]
  • Attempts to log in to Citrix Workspace app on Azure Active Directory-joined machines might fail. The issue occurs when the authentication prompt doesn’t appear. [RFWIN-21624]
  • When you launch a published desktop session, the Self-Service plug-in dialog appears in the foreground. The issue occurs when the Local App Access policy is enabled on the Delivery Controller. [RFWIN-21629]
  • Attempts to switch windows using the ALT + Tab keys might result in a blank Citrix Workspace app screen. The issue occurs when you launch the session in windowed mode. [RFWIN-21828]
  • If you’re using a webcam or a video in a Microsoft Teams call, the HDXrtcengine.exe might turn unresponsive. For a workaround, see Knowledge Center article CTX296639. [HDX-29122]

Known issues in 2012.1

No new issues have been observed in this release.

Known issues in 2012

  • If you try to add a protected app to your Favorites, this message might appear, “Your apps aren’t available at this time” When you then click OK, this message appears, “Cannot add app.” After you switch to the Favorites screen, the protected app is listed there, but you can’t remove it from Favorites. [WSP-5497]
  • In the Chrome browser with browser content redirection, when you click a link that opens a new tab, the tab might not open. As a workaround, select Always allow pop-ups and redirects in the Pop-ups blocked message. [HDX-23950]
  • Automatic update of Citrix Workspace app from Version 2012 to a later version fails with the following error message:

    Could not load file or assemble Newtonsoft.Json

    The issue occurs only when automatic update is enabled on an admin-installed instance of the Citrix Workspace app.

    As a workaround, download Citrix Workspace app Version 2012.1 or later from the Citrix Downloads page and install it manually.

    [RFWIN-21715]

  • If you launch the app bar and then open the Connection Center menu in Citrix Workspace app for Windows, the app bar doesn’t appear under the server that hosts it. [HDX-27504]
  • If you use Citrix Workspace app for Windows and launch the app bar in a vertical position, the bar covers the Start menu or the system tray clock. [HDX-27505]

Known issues in 2010

No new issues have been observed in this release.

Known issues in 2009.6

  • Attempts to minimize or maximize the Citrix Workspace app screen might distort the screen momentarily. [RFWIN-20692]

Known issues in 2009

No new issues have been observed in this release.

Known issues in 2008

  • The Print Screen key might not capture screenshots even if/when the protected windows are minimized. When this issue occurs, exit and restart the Citrix Workspace app. [RFWIN-16777]
  • When a non-administrator logs in with the FastConnect API, the Self-Service window is blank. As a workaround, restart the client device. [RFWIN-19804]
  • When you launch a protected VDA session, attempts to capture a screenshot on a non-protected VDA are blocked. [RFWIN-19823]

Known issues in 2006.1

  • If the Media Foundation feature is uninstalled on a Windows 2012 R2 machine, the instance of Citrix Workspace app installed on that server turns unresponsive. [RFWIN-17628]

Known issues in 2002

  • When you launch Microsoft Word both in a published session and on your local device and delete the store from Accounts, the following error message appears when you launch the app on the local device:

    Do you want to find an application in Citrix Workspace to open this file?

    [RFWIN-15884]

  • Attempts to launch a session on an SSL-enabled VDA might fail. [RFWIN-16129]
  • In a protected desktop session, attempts to take a screenshot of a non-protected session might fail. [RFWIN-16704]
  • You might not be able to remove store details that were added using the Group Policy Object (GPO) administrative template using the GUI. [RFWIN-16754]
  • Attempts to change the display in a protected session cause the session to exit. [RFWIN-16784]

Known issues in 1911

  • Unable to connect to the StoreFront using the DUO authentication. [LD1497]
  • The session window doesn’t appear in the foreground. [LD2089]
  • The session might turn unresponsive in a double-hop scenario. [LD2185]
  • When a webcam is used through generic USB redirection in a cloud deployment, the session turns unresponsive with a blue screen. [LD2432]
  • During session launch, the progress bar displays the Connecting.. message instead of the selected app name. [LD2450]
  • On a system configured with Dell Wyse RAM, the Citrix Workspace app installation fails with the following error:

    “The system cannot open the device or file specified”.

    [LD2480]

  • In a multi-display setup, the text might appear unclear. [LD2484]
  • When you undock the laptop in a session, it turns unresponsive for some time and then the following error appears:

    Connection interrupted

    [LD2496]

  • When you configure the bidirectional content redirection feature using the Group Policy Object administrative policy, and you clear the option Enable URL-specific published application or desktop overrides, the configuration is unsuccessful and the following error appears:

    No entries were added to the list. Make sure you added one entry in the list.

    [LD2510]

  • In a Microsoft Teams meeting, when you set the video to On, the self-video preview might flicker frequently. [RFWIN-11993]
  • On a Windows 10 RS 6 system, when you set the UDT to Off and disable the network using the firewall command, the Common Gateway Protocol might not work. This is a third-party limitation. As a workaround, enable the HDX Adaptive Transport policy on the DDC. [RFWIN-15116]
  • The resource name is appended with 1 when the same resource is enabled in one site and disabled in the other. [RFWIN-15395]
  • In Microsoft Teams, the video does not recover after disconnect and reconnect while the video preview is up. [RFWIN-15539]

Known issues in 1909

  • With bidirectional content redirection enabled, the Internet Explorer window does not appear in the foreground. [LD1924]
  • When you switch users using CTRL+ALT+DEL, trying to reconnect to a session might fail and turn unresponsive. The following message appears:

    Connected to Desktop

    [LD2063]

  • When you set the SelfServiceMode option to False in the Registry editor and click Refresh, the app shortcuts are not deleted from the Start menu. [LD2126]
  • URL redirection fails for URLs with more than 2048 characters. [LD2210]

Third-party notices

Citrix Workspace app for Windows might include third-party software licensed under the terms defined in the following document:

Citrix Workspace app for Windows Third-Party Notices (PDF Download)

About this release