About this release

Native support for Mac with Apple Silicon (M1 Series) Universal architecture

Citrix Workspace app for macOS now natively supports Macs with Apple silicon (M1 Series) by way of a universal architecture. With the universal architecture, the Citrix Workspace app runs natively on both Apple silicon and Intel-based Mac computers without Rosetta emulation. The build runs natively on Macs with Apple silicon (M1 Series) and it must be installed and tested on Macs using M1 Series.

Note:

Citrix continues to support Intel-based Macs that use the Rosetta 2 dynamic binary translator. However, Citrix will soon deprecate the Citrix Workspace app for Mac that uses Rosetta emulation. Keep a look out for an announcement in the Deprecation section.

You can now download either the Universal Architecture build or Intel build from the Citrix Workspace App for macOS (Apple silicon) section at Downloads. If you’re using Citrix Workspace app on a Mac running Mac with Apple silicon (M1 Series), you must upgrade the HDX RealTime Optimization Pack (RTOP). This ensures that the audio-video conferencing and Voice over Internet Protocol enterprise telephony through Microsoft Skype for Business is optimized. You can install the HDX RealTime Media Engine 2.9.500 for Mac from the Citrix website at Downloads.

If your organization uses any third-party plug-ins or virtual channels, you must ensure that these plug-ins are compatible with Macs running Apple silicon. If the plug-ins are developed in-house then you must rebuild these plug-ins before installing the universal architecture build.

For more information such as uninstalling the universal architecture build or using the Custom Virtual Channel SDK (VCSDK), see the Native support Apple silicon section.

What’s new in 2301

Background blurring and replacement for Citrix Optimized Teams

Citrix Optimized Teams in Citrix Workspace app for Mac now supports background blurring and background replacement. You can use this by selecting More > Apply Background Effects when you are in a meeting or a P2P call.

Auto-update version control [Technical Preview]

Administrators can now manage the auto-updated version of Citrix Workspace app for the devices in the organization. Administrators can control the version by setting the range in the maximumAllowedVersion and minimumAllowedVersion properties in the Global App Config Service.

Example JSON file in Global App Config Service:


{
    “category”: “AutoUpdate”,
              “userOverride”: false,
              “assignedTo”: [
                “AllUsersNoAuthentication”
              ],
              “settings”: [
                {
                  “name”: “Auto update plugins settings”,
                  “value”: [
                    {
                      “pluginName”: “Citrix Workspace”,
                      “pluginId”: “D99C3E77-FBF5-4B97-8EDA-4E381A1E0826”,
                      “pluginSettings”: {
                        “deploymentMode”: “Update”,
                        “upgradeToLatest”: false,
                        “minimumAllowedVersion”: “22.12.0.21”,
                        “maximumAllowedVersion”: “22.12.0.21”,
                        “delayGroup”: “Medium”,
                        “stream”: “”,
                        “ftu”: false,
                        “blocking”: false,
                        “detectRule”: “”
                      }
                    }
                  ]
                }
              ]
            }

<!--NeedCopy-->

When the range is set, Citrix Workspace app on the user’s device is automatically updated to the highest available version that falls between the mentioned range.

If you want to auto-update Citrix Workspace app to a specific version, enter the same version in the maximumAllowedVersion and minimumAllowedVersion properties in the Global App Config Service.

Note:

  • To achieve auto-update version control, upgradeToLatest setting in the Global App Config Service must be set to false. If this is true, maximumAllowedVersion and minimumAllowedVersion will be ignored.
  • Do not modify the pluginId as this is mapped to Citrix Workspace app.
  • If the administrator hasn’t configured the version in the Global App Config Service, Citrix Workspace app is updated to the latest available version by default.
  • You can only use the version ranges that are set to update Citrix Workspace app. However, downgrade is not supported.
  • This feature is supported from release 2301 onwards.

You can provide feedback for this technical preview by using the Podio form.

Note:

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

Improved auto-update experience [Technical Preview]

The automatic update feature automatically updates the Citrix Workspace app to the latest version, without any user intervention. Citrix Workspace app periodically checks for any latest updates and downloads the latest available version of the app. By default, automatic updates are enabled, unless it is explicitly disabled by your admin.

Installation starts when the Citrix Workspace app or the sessions are idle.

Note:

Citrix Workspace app cannot be accessed during the installation.

When you start the Citrix Workspace app, a notification appears to indicate the status of the installation.

You can disable the auto-update feature by navigating to Preferences > Advanced > Updates and unselecting the Automatically keep Workspace app up to date option.

You can provide feedback for this technical preview by using the Podio form.

Note:

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

Client App Management [Technical Preview]

Starting with 2301 release, administrators can manage auto-update of EPA Clients for macOS through the Citrix Workspace app and single sign-on to Citrix Secure Access if you have already signed in to Citrix Workspace app.

Auto-update of Endpoint Analysis (EPA)

You can now manage auto-update of EPA Clients for macOS through the Citrix Workspace app. Administrators must specify the agents required on end users’ devices in the Global App Configuration Service. If the agent is already installed and a new version of the agent is available, then the Citrix Workspace app updates the agent to the next higher version. Citrix Workspace app ensures to automatically update the agents whenever a new update is available in the future.

Example JSON file in Global App Config Service:


{
    “category”: “AutoUpdate”,
             “userOverride”: false,
             “assignedTo”: [
               “AllUsersNoAuthentication”
             ],
             “settings”: [
               {
                 “name”: “Auto update plugins settings”,
                 “value”: [
                   {
                     “pluginName”: “Citrix EPA”,
                     “pluginId”: “7303CB73-42EE-42BB-A908-9E6575912106”,
                     “pluginSettings”: {
                       “deploymentMode”: “Update”,
                       “upgradeToLatest”: false,
                       “minimumAllowedVersion”: “1.0”,
                       “maximumAllowedVersion”: “5.0”,
                       “delayGroup”: “Medium”,
                       “stream”: “”,
                       “ftu”: false,
                       “blocking”: false,
                       “detectRule”: “”
                     }
                   }
                 ]
               }
             ]
           }

<!--NeedCopy-->

The meaning of the properties and their possible values for the deploymentMode key are as follows:

  • “InstallAndUpdate”: Plugin can be freshly installed and can updated with new version.
  • “Update”: Only update should be allowed, no fresh install.
  • “None”: No action needed for this plugin.

Single sign-on to Citrix Secure Access using Citrix Workspace app

Starting with 2301 release, you can single sign-on to Citrix Secure Access if you have already signed in to Citrix Workspace app. When you sign in to Citrix Workspace app and open Citrix Secure Access, you will not be asked to authenticate by entering the credentials. It automatically proceeds with the authentication. This feature provides users with a seamless experience by allowing single sign-on to different Citrix applications. This feature is available only for customers on cloud stores. Along with the latest version of Citrix Workspace app, you must have a compatible version of Citrix Secure Access (22.12.2 and later versions).

You can provide feedback for this technical preview by using the Podio form.

Note:

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

Enhanced notch screen support

Starting with 2301 release, Citrix Workspace app for Mac supports Macs with a notch display. Macs support native notch screen in full screen mode for retina and multi-monitor displays. The area of the session in notch screen is now much bigger and provides the customers with more screen space. This enhancement also supports high DPI scaling. The mouse position also appears accurate in all the external monitors connected.

Note:

Ensure not to select the Scale to fit below built-in camera option in the Citrix Viewer. This option is not selected by default and can be found only on Macs with notch display.

App Protection enhancement

Starting with 2301 release, App Protection is enhanced to protect the Citrix Workspace app. This enhancement includes protecting the authentication screen and the screen that you see after signing into the Workspace app. For more information, see App Protection enhancement.

Improved virtual apps and desktops launch experience [Technical Preview]

Starting with 2301 release, the opening of Citrix resources has been enhanced to be more intuitive, informative, and user friendly.

CVAD launch

The launch progress notification now appears at the bottom-right corner of your screen. A progress status of the resources, which are in the process of being opened is shown. You cannot retrieve the notification once you dismiss it. The notification stays for a few seconds from the time you start the session. If the session fails to start, then the notification shows the failure message.

CVAD launch web

Connection failed

Note:

This feature is available for both Workspace (cloud) and storefront sessions.

You can provide feedback for this technical preview by using the Podio form.

Note:

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

Global App Configuration Service channel support [Technical Preview]

The 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.

Administrators can now use the Global App Config Service to define settings, which are applicable to specific user-groups. This ensures that some features or functionalities can be made available to only certain users as required, and not to others.

You can provide feedback for this technical preview by using the Podio form.

Note:

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

Enhanced menu bar support

Starting with 2301 release, the CWA fully supports the Automatically hide and show the menu bar in full screen option in MacOS. For versions earlier than macOS 13, you must navigate to System Preferences > Dock & Menu Bar and uncheck the Automatically hide and show the menu bar in full screen option. For macOS 13 and later versions, you must navigate to System Preferences > Desktop & Dock and uncheck the Automatically hide and show the menu bar in full screen option. You have the provision to either enable or disable this option. This enhancement also supports high DPI scaling. The mouse position also appears accurate in all the external monitors connected.

The figure below illustrates a window where the menu bar is hidden

Menu bar hidden

The figure below illustrates a window where the menu bar appears

Menu bar not hidden

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 107.1.1.13, based on Chromium version 107. For more information about the Citrix Enterprise Browser, see the Citrix Enterprise Browser documentation.

Set Citrix Enterprise Browser as the work browser

You can now configure Citrix Enterprise Browser as a work browser to open all work links. You can select an alternate browser to open non-work links.

A work link is a link that is associated with the web or SaaS apps that are configured by the administrator for the end user. When a user clicks any link within a native application, if it’s a work link, it’s opened through the Enterprise Browser. If not, it’s opened through the alternate browser that the end-user selects.

For more information, see Set Citrix Enterprise Browser as the work browser.

Fixed issues in 2301

  • HTTP Live Streaming (HLS) protocol with High-Efficiency Advanced Audio Coding (AAC-HE) stream fails to playback audio on Citrix Enterprise Browser. [CTXBR-3899]

  • When you click a hyperlink in the custom portal, an error message appears before opening the link. Later, the link opens in a system browser, for example, Google Chrome instead of Citrix Enterprise Browser. [CTXBR-4051]

  • When using Citrix Workspace app for Mac with a custom web store URL, the versions of operating system and Citrix Workspace app might not be shown in the user agent string. [CVADHELP-21377]

  • With this fix, certain third-party apps such as Epic or Kronos might not freeze when you start them. [HDX-46140]

  • When you attempt to start a session using an ICA file from Citrix Workspace app 2301 for Mac Beta build for the first time, the session might quit unexpectedly. [HDX-47361]

  • When you add the custom portal site to Citrix Workspace app for Mac, a blank page might appear. [RFMAC-12857]

Known issues in 2301

  • On macOS Ventura devices, progressive web apps (PWA) fail to open. The following error message appears:

    App Name is damaged and can’t be opened. You should move it to the Bin.

    As a workaround, right-click on the app and select Open. If you are using the keyboard, press the Ctrl key and click on the app. Select Open. [CTXBR-3885]

  • An infinite loading spinner might appear when users sign in to Citrix Workspace associated with Global App Config Service. Storefront and Custom Web Stores are not impacted by this issue. [RFMAC-13086]

Earlier releases

This section lists features in previous releases along with their fixed and known issues. Releases reach End of Life (EOL) 18 months after the release date. For details about lifecycle dates for the supported versions, see Lifecycle Milestones for Citrix Workspace app and Citrix Receiver.

2211

Workspace apps appear in the Dock with native app icons when opened [Technical Preview]

Starting with 2211 release, this feature is disabled by default.

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

Improved Mission Control and App Expose experience [Technical preview]

Starting with 2211 release, this feature is disabled by default.

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

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 105.2.1.40, based on Chromium version 105. For more information about the Citrix Enterprise Browser, see the Citrix Enterprise Browser documentation.

Fixed issues in 2211

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

2210

macOS 13 Ventura Support

Citrix Workspace app for Mac is supported on macOS 13 Ventura (13.0).

Improved automatic update experience on Mac with Apple Silicon (M1 Series)

Starting with this release, when you download the Universal Architecture build, you have the option to select between the Apple Silicon and Intel builds to support both, the Apple Silicon and Intel based Mac machines.

Automatic Updates

On Apple Silicon machines, the users have the option to automatically update the Intel build even after having downloaded the Apple Silicon build. The option is provided in the Preferences tab.

Advanced configuration for automatic updates

You can configure Citrix Workspace automatic updates on Mac with Apple silicon (M1 Series) using the following methods:

  • Graphical user interface
  • Global App Config Service (GACS)
  • Mobile Device Management (MDM)
  • StoreFront

For more information, see Advanced configuration for automatic updates.

Workspace apps appear in the Dock with native app icons when opened [Technical Preview]

Previously, clicking virtual apps in the Citrix Workspace app triggered the Citrix Viewer where these apps would be available. If you open many apps, the apps or its instances opened in the Citrix Viewer. You can view the open apps by right-clicking the Citrix Viewer icon.

Viewer grouping

Starting with this release, when you open virtual apps, they appear in the Dock with their respective icons and are easily identifiable. You can then access the virtual app from the dock itself. If you open multiple instances of an app, these instances are not duplicates in the Dock but are grouped within one instance in the Dock.

Dock grouping

Note:

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

Improved Mission Control and App Expose experience [Technical preview]

Previously, using the Mission Control or App Expose feature in a virtual app session resulted in the overlapping of many windows that were opened.

Before MissionCOntrol

Starting with this release, when you use the Mission Control or App Expose feature in a virtual app session and open many windows, the windows do not overlap, and you can easily choose from among them.

After MissionControl

Note:

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

Keyboard input mode enhancements [Technical preview]

Citrix Workspace app for Mac provides UI to configure the keyboard input mode.

To configure keyboard input mode by using the GUI, do the following:

  1. From the Citrix Workspace app icon in the menu bar, click the account icon in the top-right corner and navigate to Preferences > Keyboard.

    The Keyboard input mode settings appear

  2. Select from one of the following options:

    • Scancode – Sends the key position from client-side keyboard to VDA and VDA generates the corresponding character. Applies server-side keyboard layout.
    • Unicode - Sends the key from the client-side keyboard to VDA and VDA generates the same character in VDA. Applies client-side keyboard layout.

This enhancement is enabled by default.

Scancode unicode

For example, consider a scenario where you’re using a US international keyboard layout and the VDA is using the Russian keyboard layout. When you choose Scancode and type the key next to Caps Lock, the scancode “1E” is sent to the VDA. The VDA then uses “1E” to display the character “ф”. If you choose Unicode and type the key next to Caps Lock, the character “a” is sent to the VDA. So, even if the VDA uses the Russian keyboard layout, the character “a” appears on the screen.

Citrix recommends the following keyboard input mode for the different keyboard layout sync options:

  • Scancode mode for Don’t Sync option.

  • Unicode mode for Allow dynamic sync and Sync only once - when session starts

Note:

The keyboard configuration changes take effect once you reconnect to the application.

You can change the configuration of Keyboard input mode in the Citrix Workspace app UI. However, for best performance, use the Citrix-recommended modes for different scenarios, physical keyboards, and client devices.

For more information on configuration details and limitations, see Keyboard layout synchronization.

Note:

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

Upgraded version of WebRTC for the optimized Microsoft Teams [Technical preview]

The version of WebRTC that is used for the optimized Microsoft Teams is upgraded to version M98.

Note:

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

Improved graphics performance [Technical preview]

With this release, the performance of graphics is significantly improved for desktop sessions.

Note:

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

Support for high DPI

You can now enable and match the client DPI scale settings by launching the session toolbar and navigating to Preferences > General > High DPI. The High DPI option is disabled by default.

High DPI

Support for admin configuration of user devices through MDM tool

Admins can now configure the following settings while deploying Citrix Workspace app through any MDM deployment tool such as Citrix Endpoint Management:

  • StoreURLs – Configure store details so it’s automatically added when the user opens the Citrix Workspace app, simplifying the sign-on experience. To add a store, provide the details for the StoreURLs setting. For example, <string>https://myorg.com/Org/storename</string>

  • BlockStoreAddition – Prevent the user from adding stores.

    To block the user from adding a store, set the value of the BlockStoreAddition setting to True.

Support for certificate-based authentication [Technical Preview]

You can now authenticate to Citrix Workspace app (cloud stores) by using a client certificate.

Previously, Certificate based authentication was supported on on-premises setups and customers on cloud setups were unable to sign in to Citrix Workspace app. This feature is disabled by default and admins must contact Citrix help desk to enable this feature by filling this request form.

If your organization has configured Conditional Access with Azure Active Directory, then the user is prompted to select a Client Certificate for authentication while signing in. Certificate-based authentication adds another layer of security, ensuring that your device is compliant.

Once you add a store and enter valid credentials for that store, Citrix Workspace app displays a list of valid certificates available in your keychain for Client Authentication. If there’s only one valid certificate in your keychain, it’s selected by default.

Select certificate

Once you choose a certificate, the identity provider validates it and the Workspace app store appears on successful validation.

Note:

  • If there are no valid certificates in your keychain, the Citrix Workspace app performs the default handling for the certificate authentication request from the server. This might prevent the user from logging in.
  • If your organization has configured Conditional Access with Azure Active Directory and valid certificates are not found in your keychain, you can’t log in to Citrix Workspace app.

If a previously selected certificate is no longer valid, an error message appears, prompting you to select a valid certificate or to contact your admin in the absence of one.

Invalid certificate

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

Note:

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

Rebranding Citrix Workspace Browser

Citrix Workspace Browser is now Citrix Enterprise Browser. The custom scheme is now changed from citrixworkspace:// to citrixbrowser://.

Implementing this transition in our products and their documentation is an ongoing process. Your patience during this transition is appreciated.

  • The product UI, in-product content, and the images and instructions in product documentation will be updated in the coming weeks.
  • It is possible that some items (such as commands and MSIs) might continue to retain their former names to prevent breaking existing customer scripts.
  • Related product documentation

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 105.1.1.19, based on Chromium version 105. For more information about the Citrix Enterprise Browser, see the Citrix Enterprise Browser documentation. and other resources (such as videos and blog posts) that are linked from this product documentation might still contain former names.

Make Citrix Enterprise Browser the work browser [Technical Preview]

You can now configure Citrix Enterprise Browser to open all work or enterprise links and apps configured by your administrator in the Citrix Workspace app. This feature provides a way for you to open only work links or web and SaaS apps in the Citrix Enterprise Browser. You can select an alternate browser to open any other non-work links or apps.

Open all web and SaaS apps through the Citrix Enterprise Browser

From this release, all internal web apps and external SaaS apps available in the Citrix Workspace app open in Citrix Enterprise Browser.

Support for browser extensions [Technical Preview]

You can add extensions that are provided by your administrator to the Citrix Enterprise Browser in a secure way. An administrator can deploy, manage, and control the extensions. End users can view and use the extension under citrixbrowser://extensions as required. For more settings, see Global App Configuration Service.

Note:

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

For information on how to configure, see Citrix Enterprise Browser documentation.

Use Global App Config service to manage Citrix Enterprise Browser [Technical Preview]

The administrator can use the Global App Configuration service for Citrix Workspace to deliver Citrix Enterprise Browser settings through a centrally managed service.

The Global App Configuration service is designed for administrators to easily configure Citrix Workspace and manage the Citrix Workspace app settings. This feature allows admins to use the Global App Configuration Service to apply various settings or system policies to the Citrix Enterprise Browser on a particular store. The administrator can now configure and manage the following Citrix Enterprise Browser settings using the Global App Configuration service:

  • “Enable CWB for all apps” - Makes the Citrix Enterprise Browser the default browser for opening web and SaaS apps from the Citrix Workspace app.
  • “Enable save passwords” - Allow or deny end users the ability to save passwords.
  • “Enable incognito mode” - Enable or disable incognito mode.
  • “Managed Bookmarks” - Allow administrator to push bookmarks to the Citrix Enterprise Browser.
  • “Enable developer tools” - Enable or disable developer tools within the Enterprise Browser.
  • “Delete browsing data on exit” - Allow the administrator to configure what data the Citrix Enterprise Browser deletes on exit.
  • “Extension Install Force list” - Allow the administrator to install extensions in the Citrix Enterprise Browser.
  • “Extension Install Allow list” - Allow the administrator to configure an allowed list of extensions that users can add to the Citrix Enterprise Browser. This list leverages the Chrome Web Store.

Notes:

  • This feature is a request-only preview. To get it enabled in your environment, fill out the Podio form.
  • 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’s advised that Beta builds aren’t deployed in production environments.
  • The name and value pair are case-sensitive.
  • All the browser settings in Global App Configuration Service are under the following category:

{
    "category": "browser",
    "userOverride": false,
    "assignedTo": [
    "AllUsersNoAuthentication"
    ]
}

<!--NeedCopy-->

Fixed issues in 2210

  • Citrix Workspace app might interrupt the restart or shutdown power action of a Mac device. [RFMAC-12530]
  • Shift key might not work as expected in Citrix Workspace app for Mac version 2206. [CVADHELP-20674]

  • Shift key might not work as expected in Citrix Workspace app for Mac version 2206. [CVADHELP-20674]

2209

Sign out of custom web store when you close Citrix Workspace app

When the signoutCustomWebstoreOnExit setting is set to True, closing the Citrix Workspace app window signs you out of the custom web store. When you reopen the Citrix Workspace app, the web store URL is loaded again. You can configure the signoutCustomWebstoreOnExit setting in the Global App Configuration service.

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser (formerly Citrix Workspace Browser) version 103.2.1.10, based on Chromium version 103. For more information about the Citrix Enterprise Browser, see the Citrix Enterprise Browser documentation.

Fixed issues in 2209

  • Citrix Workspace app for Mac might start automatically when you restart Citrix Workspace app for Mac or install Citrix Workspace app. [RFMAC-12392]

  • The screen sharing feature in Optimized Microsoft Teams for certain third-party apps might fail on Citrix Workspace app for Mac. The issue occurs when the Thinwire codec policy is set to For entire screen. As a result, the app sharing feature is disabled and no options are available in the sharing panel. [CVADHELP-20853]

2208.1

View apps, desktops, and Citrix Enterprise Browser from menu bar through a quick access menu

You can now view your most recently used or favorite apps and desktops or open a Citrix Enterprise Browser window by clicking the Citrix Workspace icon in the menu bar. This feature provides easy access to some of your resources without having to open the Citrix Workspace app.

Note:

This feature is not available on on-premises setups.

Recent favarites

If you’ve not configured any accounts, a sign-in prompt appears.

Sign-in screen

A maximum of 5 of your recently used or favorite apps or desktops appear in the options under the Recent and Favorites tabs respectively. To view the other apps in the Citrix Workspace app, click View all applications. To view the other desktops in the Citrix Workspace app, click View all desktops.

Recent favarites

You can open the Citrix Workspace UI by clicking the Citrix Workspace app icon.

CWA icon

You can open the Citrix Enterprise Browser, without opening a web or SaaS app by clicking the Citrix Enterprise Browser icon.

Browser icon

Note:

The Citrix Enterprise Browser is not available if the configured store doesn’t have any web or SaaS apps. Further, it is available only if your admin has configured Citrix Secure Private Access.

Options

You can view the following options when you click the Account icon in the top-right corner:

  • Preferences
  • Check for updates
  • About
  • Quit

Support for authentication using FIDO2 [Technical Preview]

With this release, users can authenticate virtual apps or desktops by using FIDO2 security keys. FIDO2 security keys provide a seamless way for enterprise employees to authenticate to apps or desktops that support FIDO2 without entering a user name or password. For more information about FIDO2 see FIDO2 Authentication.

This feature currently supports roaming authenticators (USB only) with PIN code and touch capabilities. You can configure FIDO2 Security Keys based authentication. For information about the prerequisites and using this feature, see Local authorization and virtual authentication using FIDO2.

When you access an app or a website that supports FIDO2, a prompt appears, requesting access to the security key. If you’ve previously registered your security key with a PIN (a minimum of 4 and a maximum of 64 characters), then you must enter the PIN while signing in.

If you’ve registered your security key previously without a PIN, simply touch the security key to sign in.

Note:

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

Battery status indicator

The battery status of the device now appears in the notification area of a Citrix Desktop session. To view the battery status within the desktop session, click the Show hidden icons arrow in the taskbar.

Battery status indicator

Note:

The battery status indicator does not appear for server VDAs.

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 103.1.1.14, based on Chromium version 103. For more information about the Citrix Enterprise Browser, see the Citrix Enterprise Browser documentation.

Citrix Enterprise Browser Profiles

Profiles help you keep personal information such as history, bookmarks, passwords, and other settings separate for each of your Citrix Workspace accounts. Based your Workspace store, a profile is created, allowing you to have a unique and personalized browsing experience.

Note:

After you upgrade to version 103.1.1.14 and sign in to the device for the first time, only your previously saved passwords are removed. When you sign in to the device using a different store for the first time, all your previously saved data is lost.

Open all web and SaaS apps through the Citrix Enterprise Browser [Technical Preview]

From this release, all internal web apps and external SaaS apps available in the Citrix Workspace app open in Citrix Enterprise Browser. 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.

Fixed issues in 2208.1

  • When the Citrix Workspace login prompt appears, clicking the Cancel button doesn’t close the popup and it appears repeatedly. [CVADHELP-19919]

  • If you’re using Direct Workload Connection in Citrix Cloud to connect to VDAs directly, a black screen appears and you’re disconnected from the VDA. This issue occurs when Network Location Service (NLS) is enabled. [HDX-40588]

  • When you use a multi-touch gesture to swipe between full-screen apps, the Citrix Workspace desktop session window turns black for a moment. This issue occurs on Macs with a notch display. [HDX-42314]

2206.1

Uninstall app by dragging the Citrix Workspace app icon to the bin

You can now simply drag or move the Citrix Workspace app icon into the bin to completely uninstall the app.

Previously, dragging the Workspace app icon into the bin would remove the app but leave behind certain system files on your Mac. With this release, the Citrix Workspace app and all its associated files are removed from your device when you drag the icon to the bin.

To uninstall the Citrix Workspace app by dragging it to the bin, do the following:

  1. Close the Citrix Workspace app, if it’s running.
  2. Drag the Citrix Workspace app to the bin. Alternatively, you can right click on the Citrix Workspace app and select Options > Move to Bin.
  3. Provide your system credentials when prompted.
  4. Close all running apps (Citrix Workspace) and click Continue to confirm. The Citrix Workspace app and all its system files are deleted from your device.

Support for service continuity in the Safari browser

The Citrix Workspace service continuity feature is now supported for the Safari browser. Users must install Citrix Workspace app for Mac and the Citrix Workspace web extension. Service continuity removes (or minimizes) the dependency on the availability of the components involved in the connection process. It allows you to connect to your virtual apps and desktops regardless of the cloud services’ health status. For more information, about the service continuity feature, see the section Service continuity.

Improved audio echo cancellation support [Technical Preview]

Citrix Workspace app now supports echo cancellation in adaptive audio and legacy audio codecs. This feature is designed for real time audio use cases, and it improves the user experience. Citrix recommends using adaptive audio.

Note:

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

Enhancements to Optimized Microsoft Teams

In optimized Microsoft Teams, you can now use the video function when more than one virtual desktop or app session is in use.

Battery status indicator [Technical Preview]

The battery status of the device now appears in the notification area of a Citrix Desktop session.

Battery status indicator

Note:

The battery status indicator does not appear for server VDAs.

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

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 101.1.1.14, based on Chromium version 101. For more information about the Citrix Enterprise Browser, see the Citrix Enterprise Browser documentation.

Fixed issues in 2206.1

  • The mouse pointer is misaligned on Macs with a notch display. [CVADHELP-19337]

  • You’re not signed out of the Workspace app when the inactivity timeout value lapses. This issue occurs intermittently. [CVADHELP-19812]

  • You might get an error when you try to uninstall Citrix Workspace app. [CVADHELP-19121]

  • In optimized Microsoft Teams, the video function might not work if you start another virtual desktop or app session. [HDX-40451]

  • While sharing the screen or an app during the Microsoft Teams call, your peer might see visual artifacts. This issue occurs due to unstable frame rates, such as incorrect video playback (frozen or transient black frames). This release includes improved frame rates or sampling rates that help to reduce visual artifacts. [HDX-38032]

2204

Global App Configuration Service settings for allowedWebStoreURLs

Admins can now use Global App Config Service to configure settings of Custom Web Stores. Admins can configure the Custom Web Stores by using the allowedWebStoreURLs property. For more information about the Global App Configuration Service, see Getting Started.

Support to open Citrix Workspace app in maximized mode

Admins can configure the maximise workspace window property in the Global App Configuration Service to enable the Citrix Workspace app to open in the maximized mode by default. For more information about the Global App Configuration Service, see Getting Started.

Support for high DPI monitors [Technical preview]

Citrix Workspace app for Mac is now compatible with high DPI monitors with resolution greater than 4K. On desktop sessions, apps, text, images, and other graphical elements appear in a size that can be viewed comfortably on these high-resolution monitors.

To enable this feature, run the following command in macOS terminal:

defaults write com.citrix.receiver.nomas EnableHighDPI -bool YES

Admins can edit the Display memory limit policy, which specifies the maximum video buffer size in kilobytes for a desktop session, to suit the display resolution. The default value for the Display memory Limit policy is 65536 KB and is sufficient for up to 2x4K monitors (2x32400KB). Admins must edit this value by navigating to Citrix Studio > Policies > Display memory limit and use a value of 393216 KB to use this feature.

For more information about the Display memory limit policy, see Display memory limit.

Note:

This feature works with a maximum of two connected monitors.

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.

Enhancement to Permanent Client Access License (CAL) for Remote Desktop Sessions

With this release, if you are running CAL in your environment to access remote desktops, when the client ID is greater than 15 characters, you can launch the remote desktop session with a permanent license.

To enable this feature, admins must configure the default.ica file by doing the following:

  1. In the StoreFront server, navigate to C:\inetpub\wwwroot\Citrix<StoreName>\App_Data and open the default.ica file with any editor.
  2. Add the following line in the [WFClient] section:

isRDSLicensingEnabled=On

Restore default keyboard settings

If you had previously modified the keyboard preferences in the Citrix Workspace app, you can now restore default keyboard settings. To restore the keyboard settings to its default values, open the Citrix Workspace app, navigate to Preferences > Keyboard and click Restore Defaults. Click Yes to confirm.

App Protection compatibility with HDX optimization for Microsoft Teams

With this release, full monitor or desktop sharing is disabled when App Protection is enabled for the delivery group. When you click Share content in Microsoft Teams, the screen picker removes the Desktop option. You can only select the Window option to share any open app, if the VDA is 2109 or higher. If you are connected to VDA older than 2019, no content is selectable.

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 99.1.1.8, based on Chromium version 99. For more information about the Citrix Enterprise Browser, see the Citrix Enterprise Browser documentation.

Make Citrix Enterprise Browser your default browser

You can now make Citrix Enterprise Browser your default browser. Once you have made the Citrix Enterprise Browser your default browser, all links and Web and SaaS apps open in the Citrix Enterprise Browser by default. To make Citrix Enterprise Browser your default browser on macOS, do the following:

  1. Open the Citrix Enterprise Browser and click the ellipsis icon and open the Settings menu.

  2. Click the Default Browser option on the left pane.

  3. In the Default browser page, click Make default. When prompted, click Use Citrix Enterprise Browser to confirm your choice and apply the changes.

Fixed issues

  • The mouse pointer is misaligned on Macs with a notch display. [CVADHELP-19337]

  • You’re not signed out of the Workspace app when the inactivity timeout value lapses. This issue occurs intermittently. [CVADHELP-19812]

  • You might get an error when you try to uninstall Citrix Workspace app. [CVADHELP-19121]

  • In optimized Microsoft Teams, the video function might not work if you start another virtual desktop or app session. [HDX-40451]

  • While sharing the screen or an app during the Microsoft Teams call, your peer might see visual artifacts. This issue occurs due to unstable frame rates, such as incorrect video playback (frozen or transient black frames). This release includes improved frame rates or sampling rates that help to reduce visual artifacts. [HDX-38032]

2203.1

This release includes a simplified and intuitive onboarding experience for first time users.

Simplified onboarding

Inactivity timeout for Citrix Workspace app

The inactivity timeout feature logs you out of the Citrix Workspace app based on a value that the admin sets. Admins can specify the amount of idle time that is allowed before a user is automatically signed out of the Citrix Workspace app. You’re automatically signed out when no activity from the mouse, keyboard, or touch occurs for the specified interval of time, within the Citrix Workspace app window. The inactivity timeout does not affect the already running Citrix Virtual Apps and Desktops and Citrix DaaS (formerly Citrix Virtual Apps and Desktops service) sessions or the Citrix StoreFront stores.

For more information see Inactivity Timeout for Citrix Workspace app.

PDF Universal Printing

You can now use the PDF universal printing feature when printing from a Mac. You no longer need to install the HP Color LaserJet 2800 Series PS driver when auto-creating client printers on a Mac by using the Citrix Universal Printer Driver (UPD).

For more information about using this feature, see Printing.

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 Secure Private Access 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 Citrix 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.

Support for Transport Layer Security (TLS) protocol version 1.3 on Linux VDAs [Technical preview]

If you’re running TLS version 1.3, you can now connect to virtual apps and desktops hosted on the Linux operating system.

Note:

You can’t connect to Windows virtual apps and desktops if you’re running TLS version 1.3.

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

Share apps using the ‘Share content’ feature in Microsoft Teams

You can now 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. To show a specific application, click Share content in your meeting controls and select the application of interest. After a red border appears around the app you select, peers on the call can see your app. If you minimize the app, Microsoft Teams displays the last image from the shared app. Maximize the window to resume sharing.

Multi-window chat and meetings for Microsoft Teams

Users can now use multiple windows for chat and meetings in Microsoft Teams (1.5.00.5967 or higher) when optimized by HDX in Citrix Virtual Apps and Desktops and Citrix DaaS. Users can pop out their conversations or meetings in a variety of ways. For details on 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 VDA, be aware that Microsoft will deprecate the single-window code in the future. However, you will have a minimum of nine months to upgrade to a version of the VDA/CWA that supports multiple windows (2203 or later).

Note:

This feature is available only after the roll-out of a future update from Microsoft Teams. Got more details, see Microsoft 365 roadmap.

Give or take control in Microsoft Teams

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.

To take control during screen sharing sessions, any participant 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.

Note:

This feature is available only after the roll-out of a future update from Microsoft Teams.

StoreFront to Workspace migration

As your organization transitions from on-premises StoreFront to Workspace, users are required to manually add the new Workspace URL to the Citrix Workspace app. This feature enables admins 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.

Global App Config Service

The new Global App Configuration Service for Citrix Workspace allows a Citrix administrator to deliver Workspace service URLs and Citrix Workspace App settings through a centrally managed service. For more information, see Global App Configuration Service documentation.

Extend multiple monitors in full-screen mode

You can now enter full-screen mode on two or more monitors simultaneously. To use this feature, perform the following steps:

  1. Open the Citrix Viewer.

  2. To use full-screen mode on the other connected monitors, drag the window from your primary monitor to span into the connected monitors. From the menu bar, select View > Enter Full Screen. The window goes into full screen mode on those monitors.

    Note:

    If you have previously selected the Use All Displays In Full Screen option, ensure to unselect it as this selection extends full screen on all connected monitors.

Citrix recommends using a maximum of 3 monitors, including the primary monitor.

Citrix Enterprise Browser

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

Fixed issues

  • During active sessions, the Citrix Workspace app watermark becomes transparent, displaying content from windows in the background. This issue occurs only in seamless mode. [CVADHELP-19153]

  • When launching a session from a VDA (2112 or higher) through a Citrix ADC, you might experience a session interruption, with session reliability starting but not reconnecting. [CVADHELP-19687]

  • The Large File Receive pop-up dialog from the Mimecast plug-in doesn’t appear in Outlook. [HDX-37137]

  • When the value for Path MTU Discovery (PMTUD) is not 1500 (default), users can’t fall back to TCP on an Azure cloud environment. [HDX-37215]

  • You might experience high CPU utilization on endpoint when webcam is turned on in an optimized Microsoft Teams video call. [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.” [HDX-38819]

  • Citrix Workspace app sessions might not launch if the Citrix AppFlow is configured in Citrix ADC. [HDX-39496]

  • When auto-update is disabled and you navigate to Preferences > Advanced, the Citrix Workspace app crashes. [RFMAC-10978]

2201

StoreFront to Workspace migration [Technical preview]

As your organization transitions from on-premises StoreFront to Workspace, users are required to manually add the new Workspace URL to the Citrix Workspace app. This feature enables admins to seamlessly migrate users from a StoreFront store to a Workspace store with minimal user interaction.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and 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 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 access the beta builds, open the Citrix Workspace app, right-click on Citrix Workspace in the toolbar and click Preferences > Advanced. To update to beta builds, select the Beta channel from the drop-down list.

Advanced menu

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

    Update channels

For more information about using this feature, see Update.

Extend multiple monitors in full-screen mode [Technical preview]

You can now enter full-screen mode on two or more monitors simultaneously. To use this feature, perform the following steps:

  1. Open the Citrix Viewer.

  2. To use full-screen mode on the other connected monitors, drag the window from your primary monitor to span into the connected monitors. From the menu bar, select View > Enter Full Screen. The window goes into full screen mode on those monitors.

    Note:

    If you have previously selected the Use All Displays In Full Screen option, ensure to unselect it as this selection extends full screen on all connected monitors.

Citrix recommends using a maximum of 3 monitors, including the primary monitor.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and 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.

Fixed issues

  • While selecting the candidate text from the Input Method Editor composition window using the left or right arrows in the keyboard, the input cursor doesn’t move accordingly. This issue occurs when you launch a desktop with the Use local keyboard layout, rather than the remote server keyboard layout check box is selected in the Preferences > Keyboard window of Citrix Workspace app. This issue is observed only in the Chinese and Japanese language. [HDX-34956]

  • The mouse pointer disappears intermittently in Workspace apps sessions and you are not able to click anything. [HDX-36820]

  • The desktop session closes unexpectedly when you drag a cell in a PivotTable in an Excel sheet. [HDX-37178]

  • Sometimes, you experience issues with graphics in your desktop session after you upgrade to version 2112 and when lossless and full screen H.264 codec policies are applied. [HDX-37272]

  • After you upgrade from Citrix Workspace app 2010 to version 2112, you can’t connect to desktops or apps. [RFMAC-10811]

2112

What’s new

Support for custom web stores

You can now access your organization’s custom web store from the Citrix Workspace app for Mac. Previously, you accessed all customized stores through the browser only.

Citrix Workspace app for Mac loads the custom web stores with a browser-like experience and extends App Protection capabilities to custom web stores. Making the custom portal accessible from the native Citrix Workspace App provides comprehensive capabilities and user experience for this feature. For more details about Global App Configuration Service, see Getting Started.

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

Request control in Microsoft Teams

With this release, you can request control during a Microsoft Teams call when a participant is sharing the screen. Once you have control, you can make selections, edits, or other modifications to the shared screen.

To take control when a screen is being shared, click Request control at the top of the Microsoft Teams screen. The meeting participant who’s sharing the screen can either allow or deny your request. When you’re done, click Release control.

Limitation:

The Request Control option is not available during peer-to-peer calls 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 allows you to do the following:

  • Configure and route emergency calls.

  • Notify security personnel.

Notification is provided based on the current location of the Citrix Workspace app running 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. For more information about this feature, see Support for dynamic e911 in the section Microsoft Phone System.

PDF Universal Printing (Technical preview)

The PDF universal printing feature is available with the Citrix Virtual Apps and Desktops 2112 release. This feature is disabled by default. To use this feature, you must sign up by using this web form. The feature is enabled for you once we receive your information. You also receive instructions about using the feature and the printing policies that must be enabled.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and 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.

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. Citrix Workspace Web extensions make service continuity available to users who access their apps and desktops through a browser.

Together, the Citrix Workspace app and the Workspace Web extension use Workspace connection leases to give browser users access to their apps and desktops during outages. For more information, see Service continuity

Citrix Enterprise Browser

This release of the Citrix Enterprise Browser is based on Chromium version 95. For features or bugs fixes in the Citrix Enterprise Browser, see What’s new in the Citrix Enterprise Browser documentation.

Fixed issues

  • The “Cannot connect to server error” appears when the transport protocol switches from Enlightened Data Transport (EDT) to TCP. [CVADHELP-18310]

  • If a Progressive Web App (PWA) that is protected is opened on macOS, the App Protection policies aren’t enforced. [RFMAC-10128]

2111

What’s new

  • With this release, users cannot manually roll back Citrix Workspace app for Mac to a version that is lower than the version installed on their systems. For example, if a Mac device has Citrix Workspace app Version 2109 installed on it, then you cannot manually roll back the app to version 2108 or lower.

  • Launch the remote desktop session with a permanent license, if you’re running Client Access Licenses (CAL) to access remote desktops. You can launch the remote desktop session when the client ID is greater than 15 characters.

  • To load Citrix Virtual Channel SDK on a Mac running Citrix Workspace app 2111, you must recompile your custom virtual channels. For details, see Update Custom Virtual Channels on Citrix Workspace app for Mac.

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 macOS. Admins must add the custom web store to the list of allowed URLs in the Global App Configuration Service to use this feature. After adding the URLs, you can provide the custom web store URL in the Add Account option in Citrix Workspace app. The custom web store opens in the native Citrix Workspace app for macOS.

Note:

Technical previews are available for customers to test in their non-production or limited production environments, and 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 Enterprise Browser - For new features or bugs fixes in Citrix Enterprise Browser, see What’s new in the Citrix Enterprise Browser documentation.

Fixed issues

  • On devices running macOS, Advanced Audio Coding (AAC) is not supported. [CTXBR-1844]

  • If you have configured the Citrix Workspace app using the .cr file and signed in with your credentials, there’s a delay before the home page appears. [RFMAC-9990]

  • Open a protected SaaS app, open a new tab, and separate the new tab into a new window by dragging it out of the tab bar. Now arrange two windows next to each other and open a new tab in the second window and take a screenshot. You are able to capture the screenshot for the protected SaaS app as well in. [RFMAC-10060]

  • Switching from one store to another might sign you out from the first store. [RFMAC-10137]

  • When you enter incorrect credentials while signing into the Citrix Workspace app, the “Incorrect credentials” error message doesn’t appear and an authentication prompt appears again. Sometimes, Domain\User appears in the authentication prompt instead of User name. [RFMAC-10210]

  • Calls fail when an optimized Microsoft Teams P2P call is made from Citrix Workspace app for Mac 2109 to Citrix Workspace app for Windows 2109. [HDX-35223]

2109.1

What’s new

macOS Monterey Support

Citrix Workspace app for Mac is supported on macOS Monterey (12.0.1).

Fixed issues

  • If you have opened a protected app, an unprotected SaaS app, and a protected desktop session, the browser exits unexpectedly. This issue occurs when you switch from the protected desktop session window to the unprotected SaaS app. [CTXBR-2087]

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

2109

What’s new

Note:

If Service continuity is enabled, and you upgrade to version 2109, the connection lease files are refreshed. All the existing leases are deleted and new leases are fetched as part of functionality enhancements.

Citrix Workspace app for Mac on macOS Monterey Beta

Citrix Workspace app 2109 for Mac has been tested on macOS Monterey Beta 7. Use this setup in a test environment and provide your feedback.

Caution:

Do not use Citrix Workspace app for Mac on macOS Monterey Beta versions in production environments.

Email-based auto-discovery of store

You can now provide your email address in Citrix Workspace app for Mac to automatically discover the store associated with the email address. If there are multiple stores associated with a domain, by default the first store returned by the Global App Configuration Service is added as the store of choice. Users can always switch to another store if necessary.

Citrix Enterprise Browser

Citrix Enterprise Browser is a native browser running on the client machine. It enables users to open web or SaaS apps from the Citrix Workspace app in a secure manner. The browser ensures a consistent user interface while accessing various web or SaaS apps while improving your productivity and giving you a great performance in rendering those apps.

Citrix Enterprise Browser

With a continued focus on enriching the user-experience, the new Citrix Enterprise Browser brings you an enhanced and a more native browser-like 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
  • Analytics

Admins can enable Secure Private Access or App protection policies including anti key-logging, anti-screen capture, download, printing, clipboard restrictions, and watermarking in varying combinations on a per-URL basis.

For more information, see Citrix Enterprise Browser documentation.

End Point Analysis (EPA) enhancement

Starting with this release, Citrix Workspace app for macOS supports End Point Analysis (EPA). Advanced Endpoint Analysis (EPA) scans the device for endpoint security requirements configured on the Citrix Gateway. When the scan completes successfully, a user is granted access.

Note:

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

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

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 legacy audio compression formats to provide an excellent user experience. For more information, see Adaptive Audio.

Support for H.264 Advanced Video Coding (MPEG-4 AVC) with Microsoft Teams

This release includes support for hardware accelerated H.264 video encoding/decoding, which reduces the load on CPU usage and improves your video conferencing experience. The multimedia engine of Citrix HDX optimized Microsoft Teams (HdxRtcEngine.exe) now uses Apple’s Video Toolbox framework for encoding and decoding. This framework compresses and decompresses video faster and in real time. Also, the offloading of encoding and decoding to the GPU is optimized. Hardware accelerated video decoding and encoding is enabled by default if a device supports it. This enhancement reduces the load on the CPU during multimedia usage when Microsoft Teams is optimized with HDX.

Fixed issues

  • After you sign in to the Citrix Workspace app for Mac, you are prompted for authentication after a few hours. [RFMAC-10032]

  • When you add a store in the Citrix Workspace app, change the authentication domain in the server console, leave the app idle for a few minutes, and then open any app or desktop session, the Citrix workspace app may crash. [RFMAC-10133]

  • When a virtual app or desktop is already running and you start another virtual app or desktop, Citrix Viewer appears but the virtual app does not open. This issue occurs on devices running macOS 11.6. [RFMAC-10134]

2108.1

What’s new

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

Fixed issues

When a virtual app or desktop is already running and you start another virtual app or desktop, Citrix Viewer appears but the virtual app does not open. This issue occurs on devices running macOS 11.6. [RFMAC-10134]

2108

What’s new

Citrix Workspace app for Mac now supports Maximum Transmission Unit (MTU) discovery in Enlightened Data Transport (EDT). It increases the reliability and compatibility of the EDT protocol and provides an improved user experience.

Note:

EDT MTU discovery is supported on macOS Big Sur and later.

Fixed issues

  • There is a lag in video during conference calls in Microsoft Teams. [HDX-32603]

  • On Mac clients running macOS Big Sur, an HTTP 404 or HTTP/1.1 internal server error might occur. The issue occurs when attempting to reconnect to sessions. [RFMAC-9448]

2107

What’s new

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

Fixed issues

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

2106

What’s new

Support for customized URLs through 301 redirects

You can 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.

Note:

  • Citrix Workspace app for Mac does not support Dual Tone Multi Frequency (DTMF) with Microsoft Teams due to pending changes from Microsoft.
  • From this release onward, the Citrix Viewer’s version number and the Citrix Workspace app’s version number might not match. This change does not affect your experience.

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 the Desktop Viewer is in full screen mode, the user can select one from all the screens covered by the Desktop Viewer to share. In the window mode, the user can share the Desktop Viewer window. In the seamless mode, the user can select one screen from the screens connected to the endpoint device. When the Desktop Viewer changes the window mode (maximized, restore, or minimize), the screen sharing stops.

When the user wants to share the screen, previews for all available screens appear in the screen sharing panel, making it intuitive to select the right one by from the previews.

Fixed issues

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

2104

What’s new

Citrix Workspace app for Mac supports manual user sign-on to network shares unless your organization enables single sign-on. To access shared network locations, open Citrix Workspace app, navigate to Files > Network Shares and provide your credentials. For more information about setting up network shares, see Create and manage storage zone connectors.

Fixed issues

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

2102

What’s new

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

Fixed issues

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

2101

What’s new

Apple silicon (M1 chip) support

Citrix Workspace app for Mac now supports Apple silicon devices (M1 chip) using Rosetta 2 on macOS Big Sur (11.0 and later). As a result, all third party virtual channels must use Rosetta 2. Otherwise, these virtual channels might not work in Citrix Workspace app for Mac on macOS Big Sur (11.0 and later). For more information about Rosetta, see the Apple support article.

Microsoft Teams optimization support for seamless app sessions

Citrix Workspace app for Mac now supports Microsoft Teams optimization for seamless app sessions. As a result, you can launch Microsoft Teams as an application from within the Citrix Workspace app. For more information, see the following:

Support for Dual Tone Multi Frequency (DTMF) with Microsoft Teams

Citrix Workspace app for Mac now supports Dual Tone Multi Frequency (DTMF) signaling interaction with telephony systems (for example, PSTN) and conference calls in Microsoft Teams. This feature is enabled by default.

Fixed issues

  • Attempts to open a Microsoft Teams meeting using OWA (Outlook Web App) might fail, causing all related windows to exit unexpectedly. [CTXBR-1175]
  • When you start a video call, Microsoft Teams might become unresponsive, displaying a Citrix HDX not connected error. [RFMAC-6727]
  • On macOS Big Sur (11.0.1), attempts to connect USB devices might fail, causing the session to exit unexpectedly. [RFMAC-7079]
  • In a published desktop, files saved to your local Mac device might display a file created date of 30 Nov 1979 instead of the current date. [CVADHELP-16309]
  • Sometimes, the logon screen in published apps might not display properly, resulting in a reduced window size and red background color. [CVADHELP-16027]
  • Audio calls might disconnect on your side when you disconnect and connect audio devices. [RFMAC-7371]
  • Attempts to copy text from within Office 365 apps might succeed even when the clipboard restriction policy is enabled. [CTXBR-1166]
  • Attempts to launch Microsoft Teams might fail due to issues with the HDX RealTime Connector engine and the following error message appears.

    Sorry, we couldn't connect you

    [CVADHELP-16432]

2012

What’s new

Apple silicon (M1 chip) support preview

Citrix Workspace app for Mac now supports Apple silicon devices (M1 chip) on a preview basis.

Screen sharing optimization with Microsoft Teams

Citrix Workspace app for Mac now supports screen sharing optimization with Microsoft Teams. For more information, see the following:

Performance improvements

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

Fixed issues

  • When using Citrix Workspace app for Mac 2008 or later, attempts to launch multiple instances of a published application might fail. [CVADHELP-16019]
  • Attempts to launch Generic USB redirection might fail when you use a USB docking station. [RFMAC-6687]
  • Attempts to open a window using CTRL+O in published desktops might result in two open windows. [CVADHELP-15747]
  • Attempts to launch Citrix Files from within Citrix Workspace app for Mac might fail due to issues with single sign-on. [RFMAC-4477]
  • When using Citrix Workspace app for Mac on macOS Big Sur Beta, audio calls might disconnect. The issue occurs when you disconnect audio devices and connect different audio devices during an audio call. [RFMAC-6112]
  • HDX RealTime Connector engine might exit unexpectedly when you turn the camera on and off in Microsoft Teams. [RFMAC-6293]

Known issues

Known issues in 2211

  • When using Citrix Workspace app for Mac 2209 and later versions, the user sign-in page might not be displayed while using the custom web portal. As a workaround, quit Citrix Workspace app by using the Quit option from Citrix Workspace icon in the menu bar. [CVADHELP-21377]

Known issues in 2210

  • On macOS 13 Ventura, the seamless app interaction might run into issues when you change the All at Once default option to the One at a Time option in the Stage Manager preference under the Stage Manager feature. [HDX-44567]

  • Attempts to start a desktop session in offline mode might fail. As a workaround, resize the session window. [HDX-45081]

  • When resizing a session to full-screen mode on a MacBook, the focal point of a cursor might appear slightly above the actual cursor position. As a workaround, navigate to System Preferences > Dock & Menu Bar and enable the Automatically hide and show the menu bar in full screen option. [HDX-45585]

  • With 2210 release, using Mission Control or App Expose features in an app session might cause Citrix Workspace app to close unexpectedly. [HDX-46130]

  • When launching certain third-party apps such as Epic or Kronos, the sign-in window of the apps might be covered by another window. As a result, the entire session freezes. As a workaround, perform one of the following actions:

    • Drag the window that is blocking the sign-in window away from it.
    • Locate the sign-in window using the Mission Control feature.
    • Use the keyboard shortcut Command+~ to switch windows.

    [HDX-46140]

Known issues in 2209

No new issues have been observed in this release.

Known issue in 2208.1

No new issues have been observed in this release.

Known issue in 2206.1

No new issues have been observed in this release.

Known issue in 2204

  • When traffic is tunneled through NGS, Citrix Workspace app might fail to upload or download files that are greater than 64 MB. [CTXBR-3354]

Known issues in 2203.1

  • You can’t click the Create button in the Jira app unless the browser window is maximized. [CTXBR-1976]

  • Web socket connections aren’t tunneled through Citrix Secure Private Access. [CTXBR-2439]

  • After upgrading the Citrix Workspace app to version 2203, a question mark icon appears on the Citrix Enterprise Browser icon. This issue occurs if the Citrix Enterprise Browser was pinned to the dock before the upgrade. [CTXBR-2864]

  • When you click the Reset settings option on the Advanced settings section of the Citrix Enterprise Browser, the log settings do not reset to default. As a workaround, click the Reset to default log settings option available on the Logs page. [CTXBR-2929]

  • After you upgrade from Citrix Enterprise Browser version 2201 to version 2203, previously saved passwords are lost and you’re unable to save new passwords. [CTXBR-3063]

  • Full screen mode is not available on Macs with a notch. [CVADHELP-19337]

  • When you launch a desktop or app session using the browser, the session window launches in the background, behind the browser window. [RFMAC-11362]

Known issues in 2201

  • The client name appears with random characters in the Citrix Broker Service and the Citrix Director if you are using the Citrix Workspace app in the offline (intranet) mode. [RFMAC-10842]

Known issues in 2112

  • 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]

Known issues in 2111

No new issues have been observed in this release.

Known issues in 2109.1

No new issues have been observed in this release.

Known issues in 2109

  • If you have configured the Citrix Workspace app using the .cr file, and signed in with your credentials, the home page appears after a delay. [RFMAC-9990]

  • If a Progressive Web App (PWA) that is protected is opened on macOS, the App Protection policies aren’t enforced. [RFMAC-10128]

  • After you add stores in the Citrix Workspace app and change the Current Reauthentication Period in Reauthentication Period for Workspace App and switch from on-premises to the cloud store after a few minutes, you are signed out of the cloud store and an authentication prompt appears. Once you sign in to the Citrix Workspace app, the spinner appears indefinitely and you are unable to sign in. [RFMAC-10140]

Known issues in 2108.1

No new issues have been observed in this release.

Known issues in 2108

  • When you start a subscribed SaaS app after changing the authentication domain in the server console, the session does not start and the following error message appears:

    “AuthDomain has changed. Please sign in again after some time”

    [RFMAC-9616]

Known issues in 2107

  • When you change the authentication domain in the server console and sign in with your credentials, the following error message appears:

    Cannot connect to the server

    You can access the store once you click OK.

    [RFMAC-9494]

Known issues in 2106

  • A black window appears when you share your screen. [HDX-30083]

Known issues in 2104

No new issues have been observed in this release.

Known issues in 2102

No new issues have been observed in this release.

Known issues in 2101

  • Attempts to access files under Network Shares from within Citrix Workspace app for Mac might fail even when the option is enabled. [RFMAC-7272]
  • On macOS Big Sur, attempts to launch the web SAML single sign-on app on Citrix Workspace app for Mac might fail, displaying the following error message.

    Page could not load. Please try again later or contact your administrator for assistance. Incident ID:-202

    [RFMAC-7282]

Known issues in 2012

  • When you start a video call, Microsoft Teams might become unresponsive, displaying a Citrix HDX not connected error. As a workaround, restart Microsoft Teams or the VDA. [RFMAC-6727]
  • Video calls on Microsoft Skype for Business are not supported on macOS Big Sur (11.0.1).
  • On macOS Big Sur (11.0.1), attempts to connect USB devices might fail, causing the session to exit unexpectedly. As a workaround, reconnect the USB device. [RFMAC-7079]

Third-party notices

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

Citrix Workspace app for Mac Third-Party Notices

About this release