About this release

Learn about new features, enhancements, fixed issues, and known issues for Citrix Workspace app for Mac.

A list of features in Technical Preview is maintained in the Features in Technical Preview section, so you can find them in one place. Explore our preview features and share your feedback using the attached Podio form link.

Note:

The auto-update service is supported on version 2304 or later. If you’re using Citrix Workspace app for Mac versions 2301 or earlier, you can’t update to the latest versions through the auto-update service. Instead, you need to manually install Citrix Workspace app for Mac versions 2304 or later by downloading the .dmg file available on the Downloads page. For more information, see Manual install.

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

With the release of the Universal Architecture build, Citrix Workspace app now provides native support for Macs with Apple silicon (M1 and M2 series). The Universal Architecture build can run on any Mac device, irrespective of their processor architecture.

If you are using the x86_64 Intel-based architecture build of Citrix Workspace app for Macs with Apple Silicon, then you must use Rosetta emulation to run the app.

You can download the latest version of Universal Architecture build and x86_64 Intel-based Architecture build at Downloads.

Note:

Citrix continues to support Intel-based Macs and Macs with Apple Silicon (M1 and M2 Series). However, Citrix will soon deprecate the x86_64 Intel-based Architecture build for Intel-based Macs. Citrix continues to support Universal Architecture build for both Intel-based Macs and Macs with Apple Silicon (M1 and M2 Series). Keep a look out for an announcement in the Deprecation section.

If you’re using Citrix Workspace app on a Mac running Mac with Apple silicon (M1 and M2 Series), you must upgrade the HDX RealTime Optimization Pack (RTOP). This upgrade 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 Native support Apple silicon section.

What’s new in 2311

Support for authentication using FIDO2 when connecting to on-premises store

Previously, FIDO2 based password-less authentication was supported for connecting to cloud stores. For more information, see FIDO2 based authentication when connecting to cloud store.

With this version, users can also connect to on-premises stores using FIDO2 authentication. 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. This feature currently supports roaming authenticators (USB only) with PIN code and touchID. This feature is supported on macOS 12 and later versions. For more information, see FIDO2-based authentication when connecting to on-premises store.

Enhanced Universal Architecture builds for virtual apps and desktops session

Starting with the 2311 version, the Universal Architecture build can now automatically choose to run the virtual sessions in the native Apple Silicon mode or Intel mode on Macs with the Apple Silicon chipset. It uses the Rosetta emulation to launch the virtual session in Intel mode. The virtual session launches in the native Apple Silicon mode, if the virtual channel SDK is built based on the native Apple Silicon architecture or there’s no virtual channel SDK. However, the virtual session launches in the Intel mode using the Rosetta emulation, if the virtual channel SDK is built based on the x86_64 Intel-based architecture.

This enhancement to the Universal Architecture build improves the launch experience on Macs with the Apple Silicon chipset. For users on Macs with the Intel-based chipset, there is no change, and the Universal Architecture build continues to run the virtual sessions natively.

For more information, see Enhanced Universal Architecture builds for virtual apps and desktops session.

Enhanced virtual apps and desktops launch experience for Workspace (Cloud users only)

The opening experience of Citrix resources has been enhanced to be more intuitive, informative, and user-friendly. From the 2311 version, this feature is supported for custom web stores and hybrid launch.

Launch experience

The launch progress notification now appears at the lower-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. For more information, see Enhanced virtual apps and desktops launch experience for Workspace (Cloud users only).

Launch failure

Note:

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

Modernized Citrix Virtual Channel SDK for Citrix Workspace app for Mac

Starting with the 2311 version, the Citrix Virtual Channel Software Development Kit (VCSDK) supports writing server-side applications and client-side drivers for more virtual channels using the ICA protocol. The server-side virtual channel applications are on Citrix Virtual Apps and Desktops servers. This version of the SDK supports writing new virtual channels and screen sharing for Citrix Workspace app for Mac.

For more information, see Citrix Virtual Channel SDK for Citrix Workspace app for Mac in the Developer documentation and Modernized Citrix Virtual Channel SDK for Citrix Workspace app for Mac.

Support for TLS protocol version 1.3

Starting with the 2311 version, Citrix Workspace app for Mac supports the latest Transport Layer Security (TLS) version 1.3. To enable the TLS version 1.3, navigate to Preferences > Security and Privacy > TLS and select the TLSv1.0, TLSv1.1, TLSv1.2 and TLSv1.3 option from the TLS versions drop-down menu.

TLS versions

For more information, see TLS.

Support for multiple audio devices

Starting with the 2311 release, Citrix Workspace app for Mac displays all available local audio devices in a session with their names. In addition, plug-and-play is also supported. For more information, see Support for multiple audio devices.

Support for extending multiple monitors in full-screen mode on up to five monitors

Previously, Citrix supported a maximum of three monitors in full-screen mode, including the primary monitor.

Starting with the 2311 version, you can now use full-screen mode on up to five monitors, including the primary monitor, at the same time. For more information, see Support for extending multiple monitors in full-screen mode on up to five monitors.

Deprecation of International menu from the keyboard settings

Previously, you can enable or disable the Use Client IME, Use Composting Mark and Use Client keyboard layout features in the Citrix viewer by navigating to Devices > Keyboard>International.

From the 2311 version, the International menu for the keyboard settings in the Citrix Viewer is deprecated. From this version, the client-side IME is enabled by default. For more information, see Deprecation of International menu from the Keyboard settings.

Deprecation announcement of the SDP format (Plan B) from WebRTC

Citrix is planning to deprecate the current SDP format (Plan B) support from WebRTC in future releases. You must use a version of Citrix Workspace app that supports the Unified Plan to continue using certain optimized Microsoft Teams functionalities. For more information, see Deprecation announcement of the SDP format (Plan B) from WebRTC.

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 119.1.1.115, based on Chromium version 119. For more information, see the Citrix Enterprise Browser documentation.

Improved user experience

Previously, Citrix Enterprise Browser displayed a reconnection modal when you attempted to perform an action after your session expired. Starting with Citrix Workspace app for Mac version 2311 (which corresponds to the Chromium version 119.1.1.115), there is no longer a reconnection modal. Instead, a loading icon now appears on the browser tab when you attempt to perform any action after your session expires.

Improved watermark design

Citrix Enterprise Browser now has a new watermark design that is less intrusive and provides a better user experience.

Support for custom browser extension

Citrix Enterprise Browser has expanded its extension capabilities. Previously, only extensions from the Chrome Web Store were permitted. Citrix Enterprise Browser now allows you to add custom extensions securely. Administrators can configure custom extensions as part of the mandatory list. End users can access and use these extensions either via citrixbrowser://extensions or by clicking the Extensions option under More button as needed. For more information on how to configure the custom extensions, see Mandatory custom browser extension in the Citrix Enterprise Browser documentation.

Simplified SSO for Web and SaaS apps through the Global App Configuration service

Note:

This feature is available only for StoreFront.

Previously, SSO was configured in Citrix Enterprise Browser using the PowerShell module. From this version, this simplified SSO feature allows you to configure SSO in Citrix Enterprise Browser by using a newly introduced setting in the Global App Configuration service (GACS). Administrators can use this new setting to enable SSO for all web and SaaS apps in Citrix Enterprise Browser. This method eliminates the need for the complex PowerShell module. For more information on how to manage SSO through GACS, see the Manage single sign‑on for Web and SaaS apps through the Global App Configuration service.

Enhanced capabilities on monitoring end user activities

Previously, administrators were unable to monitor end user activities such as App accessed and Traffic type. Starting with Citrix Workspace app for Windows 2311 and Mac 2311 versions (corresponding to Chromium version 119.1.1.115), you can now monitor these details as well.

  • App accessed: Enterprise Browser provides information about all the apps accessed by the end user, provided the app is listed in the policy document.
  • Traffic type: Enterprise Browser provides information about whether data is sent directly or through Secure Private Access authentication.

To monitor the end user activities from the Enterprise Browser, use the Citrix Analytics service using your Citrix Cloud account. After signing in to Citrix Cloud, navigate to Analytics > Security > Search. There, you can refer to Apps and Desktops under the Self-Service Search section. For more information on Citrix Analytics, see Getting started.

App Protection

Support to configure App Protection for Authentication and Self-Service plug-in for on-premises stores

Previously, Citrix Workspace app for Mac supported configuring App Protection for Authentication and Self-Service plug-in using the Global App Configuration service UI for customers on cloud stores only.

Starting with the 2311 release, it is available for customers on both cloud and on-premises stores. For more information, see Configuration using the Global App Configuration service UI in the App Protection documentation.

Technical Preview

  • Loss Tolerant mode for Audio
  • Support for Audio volume synchronization
  • Support for H.265 video decoding
  • Upgraded HDX Reducer to Version 4

For a complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues in 2311

  • When the first time users add the Store URL, they might not see the FIDO2 authentication browser window. [RFMAC-14518]
  • When using Citrix Workspace app for Mac to access virtual sessions, the mouse scrolling speed might be too fast or too slow in the virtual sessions. [CVADHELP-23514]
  • When using Citrix Workspace app for Mac, you might not be able to switch between recent apps inside the virtual app session by clicking Options + tab keys after upgrading to VDA 2212 or later. [CVADHELP-23464]
  • You might notice that the macOS dock is blocking the windows taskbar of the Remote Desktop Protocol app session launched from Citrix Workspace app for Mac. [CVADHELP-23681]
  • When using Citrix Workspace app for Mac, you might experience issue with authentication when persistent session is used for on-premises store. [CVADHELP-24062]

Known issues in 2311

  • The HTML5 Video redirection feature is disabled by default in Citrix Workspace app for Mac from version 2311. [HDX-53015]

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.

2309

What’s new

Support for macOS 14 Sonoma

Citrix Workspace app for Mac is supported on macOS 14 Sonoma.

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 115.1.1.103, based on Chromium version 115. For more information, see Citrix Enterprise Browser documentation.

Citrix will now release independent upgrades for Citrix Enterprise Browser. Starting with Citrix Workspace app 2309 for Mac, you can upgrade Citrix Enterprise Browser independently to compatible versions through the auto-update feature or install manually when the upgrades are available at Downloads. The independent upgrades of Citrix Enterprise Browser are supported only on the latest version of Citrix Workspace app for Mac at any given time.

Technical Preview

  • Support for Citrix Secure Private Access for On-premises stores

For a complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

  • In optimized Microsoft Teams, you might hear the ringtone sound randomly if you answer the call before it rings. [HDX-55799]
  • The USB settings to connect devices automatically, which is available on the Devices tab of the Preferences window, might not work as expected in Citrix Workspace app 2308 for Mac. [RFMAC-14658]
  • On macOS Sonoma devices, when you copy an image (.jpeg/.png format) from your Mac to the virtual session, the copied image in the virtual session might get corrupted. [HDX-55307]

Known issues

  • No new issues have been observed in this release.

2308

What’s new

Citrix Workspace app for Mac on macOS Sonoma Beta

Citrix Workspace app 2308 for Mac has been tested on macOS Sonoma Public Beta 7 Version 23A5337a. Use this setup in a test environment and provide your feedback.

Improved graphics performance

Starting with the 2308 version, the performance of graphics is improved for seamless app sessions. This feature also optimizes the load on CPU usage. For more information, see Improved graphics performance.

Improved network congestion control

Starting with the 2308 version, the Citrix-proprietary transport protocol called Enlightened Data Transport (EDT) is improved to efficiently control network congestion. This feature improves data throughput and reduces latency. For more information, see Improved network congestion control.

Increase in the number of supported virtual channels

Previously, Citrix Workspace app for Mac supported up to 32 virtual channels. Starting with the 2308 version, you can use up to 64 virtual channels in a session. For more information, see Increase in the number of supported virtual channels.

App Protection

Support for Policy tampering detection

Policy tampering detection feature prevents the user from accessing the virtual app or desktop session if the App Protection anti-screen capture and anti-keylogging policies are tampered. If policy tampering is detected, then the virtual app or desktop session is terminated. For more information about the policy tampering detection feature, see Policy tampering detection.

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 115.1.1.103, based on Chromium version 115. For more information, see Citrix Enterprise Browser documentation.

Technical Preview

  • Enhanced the high DPI option
  • Store-based configuration of file access
  • Support for Activity Manager on cloud stores
  • Support for screen sharing when App Protection is enabled
  • Support for authentication using FIDO2 when connecting to on-premises store

For a complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

  • When using Citrix Workspace app for Mac to access the virtual desktop, the size of the mouse pointer in the virtual desktop might fluctuate irregularly. [CVADHELP‑23158]
  • You might not see the icons of active apps in the activity manager. [WSUI‑8011]
  • Citrix Workspace app might consume a lot of application memories after a few minutes of usage. [CVADHELP‑23528]

Known issues

  • After upgrading Citrix Workspace app for Mac to version 2308, the preferences window might be unresponsive for any user actions. As a workaround, force quit Citrix Workspace app and restart it. For more information about forcing an app to close on a Mac, see Force an app to close in the Apple support article. [RFMAC‑14596]

2307

What’s new

Native support for Macs with M2 chips

Starting with the 2307 version, Citrix Workspace app for macOS supports M2 series (along with M1 series that was previously supported) of Apple silicon natively. For more information, see Native support Apple silicon.

Citrix Workspace app for Mac on macOS Sonoma Beta

Citrix Workspace app 2307 for Mac has been tested on macOS Sonoma Public Beta 1 Version 23A5286i. Use this setup in a test environment and provide your feedback.

Caution:

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

Deprecating support for macOS version Catalina

As announced in the 2304 version, support for macOS version Catalina (10.15) is deprecated in the 2307 release and will be removed for future releases. For more information, see Deprecation.

Support for authentication using FIDO2 when connecting to a cloud store

Starting with the 2307 version, users can authenticate using FIDO2 based password-less authentication when connecting to a cloud store. 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. This feature currently supports roaming authenticators (USB only) with PIN code and touchID. This feature is supported on macOS 12 and later versions. For more information, see FIDO2-based authentication when connecting to cloud store.

Support for authentication using FIDO2 within an HDX session

Starting with the 2307 version, users can authenticate using FIDO2 based password-less authentication within an HDX session. FIDO2 security keys provide a seamless way for enterprise employees to authenticate to apps or websites that support FIDO2 without entering a user name or password. This feature currently supports roaming authenticators (USB only) with PIN code. This feature is supported on macOS 12 and later versions. For more information, see FIDO2-based authentication within an HDX session.

Note:

This release supports only one passkey in a FIDO2 supported device. If your FIDO2 supported device has multiple passkeys then the first passkey is used to authenticate the HDX session.

Auto-update version control

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 for maximumAllowedVersion and minimumAllowedVersion properties in the Global App Configuration service.

Example JSON file in Global App Configuration service:


{
  "serviceURL": {
    "url": "https://serviceURL:443"
  },
  "settings": {
    "name": "Version Control for Citrix Workspace",
    "description": "Provides admin ability to Version Control for Citrix Workspace",
    "useForAppConfig": true,
    "appSettings": {
      "macos": [
        {
          "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": "23.07.0.63",
                    "maximumAllowedVersion": "23.07.0.63",
                    "delayGroup": "Medium",
                    "detectRule": ""
                  }
                }
              ]
            }
          ]
        }
      ]
    }
  }
}

<!--NeedCopy-->

When the range is set, Citrix Workspace app on the user 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 Configuration service. For more information, see Auto-update version control.

Note:

  • To achieve auto-update version control, set the upgradeToLatest setting to false in the Global App Configuration service. If the upgradeToLatest setting is true, maximumAllowedVersion and minimumAllowedVersion is ignored.
  • Do not modify the pluginId. The pluginId is mapped to Citrix Workspace app.
  • If the administrator hasn’t configured the version in the Global App Configuration 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, a downgrade isn’t supported.
  • This feature is supported from release 2307 onwards.

Quick access menu for StoreFront

Starting with the 2307 version, you can navigate to your favorite apps and desktops quickly and easily using the quick access feature for on-premises stores. To enable quick access, right-click Citrix Workspace in the toolbar, navigate to Preferences > General, and then select Show Quick Access for Storefront experience. This feature allows you to see your favorite data directly from the Mac menu bar.

On-prem quick access

You can enable the quick access feature by using Preferences.

Quick access

Administrators can enable or disable the quick access feature by using the Mobile Device Management (MDM) or Global App Configuration service (GACS) methods. For more information, see the Quick access menu for StoreFront.

Enabling or disabling quick access using MDM

To enable quick access through MDM, administrators must use the following settings:

<key>ShowQuickAccessForStoreFront</key> <false/>

Enabling or disabling quick access using GACS

To enable quick access through GACS, administrators must use the following settings:

enableQuickAccessForStoreFront

Store-based configuration of microphone and webcam access

Starting with the 2307 version, the per-store microphone and webcam access are included as part of the client-selective trust feature. This enhancement allows you to provide access to a microphone and webcam on a per-store basis.

To enable microphone and webcam access for a store, you must select Preferences > Mic & Webcam. In the Mic & Webcam tab, select the store and the type of access required for that store. For more information, see Store-based configuration of microphone and webcam access.

Send feedback on Citrix Workspace app

The Send feedback option allows you to inform Citrix about any issues you might encounter while using the Citrix Workspace app. You can also send suggestions to help us improve your Citrix Workspace app experience.

You must select Help > Send feedback to view and fill the issue details in the Send feedback form. You can add details like the examples provided in the form.

Send feedback screen

You can attach the existing log files or generate new log files. To generate log files, click Record my issue > Start Recording and then reproduce the issue. After the issue is reproduced, click Stop Recording. The log file is saved automatically and replaces the existing logs with the reproduced logs.

Note:

Citrix does not collect any Personally Identifiable Information (PII) from the logs.

You can attach screenshots or screen recordings describing the issue to help us understand what you’re experiencing. Click Choose files and add the attachments such as screenshots or screen recordings. You can attach a maximum of four files.

Once you’ve entered the necessary information, click Send to have a new email automatically created in your Mail app with the information you added. From there, click the Send button to share the feedback with Citrix. For more information, see Send feedback on Citrix Workspace app.

Note

If you aren’t using the default Mail app, then send feedback to cwa-mac-feedback@cloud.com from your mail client. Add the issue details, log files, screenshots, or screen recordings to the email manually.

Citrix Enterprise Browser

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

Split view support

Citrix Enterprise Browser on macOS supports split view for ease of multitasking. With split view, you can use Citrix Enterprise Browser and another window next to each other, without having to manually move and resize windows. For more information, see Apple’s support article.

Split view

Citrix Enterprise Browser shortcut

Starting with Citrix Workspace app for Mac 2307 version, an administrator can configure and control the presence of the Citrix Enterprise Browser shortcut on the launch pad.

Note:

By default, this feature isn’t configured.

Configuration

An IT administrator can configure the presence of the Citrix Enterprise Browser shortcut in one of the following ways:

  • Mobile Device Management (MDM)
  • Global App Configuration service (GACS)
  • web.config file.

Note:

  • All the configuration methods have equal priority. Enabling any one of them enables the shortcut.
  • If you haven’t configured the shortcut but have one or more Workspace stores, the shortcut gets automatically enabled.
  • For end users, the Citrix Enterprise Browser shortcut appears if the user makes it as a favorite app irrespective of the configuration.
  • To disable this feature for Workspace stores, administrators must apply one of the following settings:

    • Set the CEBShortcutEnabled attribute to false in the MDM or web.config file.
    • Disable the Enable Citrix Enterprise Browser shortcut property in GACS.
Mobile Device Management (MDM)

Administrators can push the settings CEBShortcutEnabled set as true to the user’s device.

For more information on how to use MDM, see Mobile Device Management (MDM).

Note:

This way of configuration is applicable on Workspace and StoreFront.

Global App Configuration service (GACS)

Navigate to Workspace Configuration > App Configuration > Citrix Enterprise Browser and enable Enable Citrix Enterprise Browser shortcut property.

Enable Citrix Enterprise Browser Shortcut-GACS

For more information about how to use the GACS UI, see the User interface article in the Citrix Enterprise Browser documentation.

Note:

This way of configuration is applicable on Workspace and StoreFront.

web.config file

Enable the attribute CEBShortcutEnabled under the properties.


                        <properties>
                            <property name="CEBShortcutEnabled" value="True" />
                        </properties>

<!--NeedCopy-->

Note:

This way of configuration is applicable on StoreFront.

Using web.config

To enable the Citrix Enterprise Browser shortcut, do the following:

  1. Use a text editor to open the web.config file, which is typically at C:\inetpub\wwwroot\Citrix\Roaming directory.

  2. Locate the user account element in the file (Store is the account name of your deployment).

    For example: <account id=... name="Store">

  3. Before the </account> tag, navigate to the properties of that user account and add the following:

    
                        <properties>
                            <property name="CEBShortcutEnabled" value="True" />
                        </properties>
    
    <!--NeedCopy-->
    

The following is an example of the web.config file:


<account>
    <clear />
    <account id="d1197d2c-ac82-4f13-9346-2ee14d4b0202" name="F84Store"
      description="" published="true" updaterType="Citrix" remoteAccessType="None">
      <annotatedServices>
        <clear />
        <annotatedServiceRecord serviceRef="1__Citrix_F84Store">
          <metadata>
            <plugins>
              <clear />
            </plugins>
            <trustSettings>
              <clear />
            </trustSettings>
            <properties>
                  <property name="CEBShortcutEnabled" value="True" />
            </properties>
          </metadata>
        </annotatedServiceRecord>
      </annotatedServices>
      <metadata>
        <plugins>
          <clear />
        </plugins>
        <trustSettings>
          <clear />
        </trustSettings>
        <properties>
          <clear />
        </properties>
      </metadata>
    </account>

<!--NeedCopy-->
How to configure using web.config
  1. Use a text editor to open the web.config file, which is typically at C:\inetpub\wwwroot\Citrix\Roaming directory.

  2. Locate the user account element in the file (Store is the account name of your deployment).

    For example: <account id=... name="Store">

  3. Before the </account> tag, navigate to the properties of that user account and add the following:

    
                        <properties>
                            <property name="CEBShortcutEnabled" value="True" />
                        </properties>
    
    <!--NeedCopy-->
    

Technical Preview

  • Keyboard accessibility support for the toolbar on the Virtual Desktop

For a complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

  • While launching the published app through the browser, the app does not launch directly but downloads an ICA file. The user might have to open the downloaded ICA file manually to launch the app. [CVADHELP-20835]

  • Attempts to start a session might fail if the StoreFront keyword is set to “KEYWORDS:LogoffOnClose=true PromptMessage=”Do you want to Log off?””. [CVADHELP-23170]

  • You might not be able to select the required gateway from the list of options provided when using Citrix Workspace app for Mac. [CVADHELP-22777]

Known issues

No new issues have been observed in this release.

2306

What’s new

Log traceability and user activity

Starting with the 2306 version, when a user reports an issue, the administrators can go through the log files to view the basic information such as macOS version, Citrix Workspace app version, details about the previous upgrade, number of stores added, and other details. Administrators can now view the following activities in Citrix Workspace app for Mac:

  • The app launched along with the macOS version, number of stores, and other metadata.
  • The store addition and deletion operation and the metadata that is required to add an account.
  • The session start time and launch status.
  • Auto update activation and status.
  • System events such as moving the app to the background, sleep mode, or quitting.

Citrix Enterprise Browser

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

Fixed issues

  • After upgrading Citrix Workspace app for Mac to version 2305, certain third-party virtual apps that have pop-up dialogs for entering username and password might become unresponsive upon opening. [CVADHELP-23032]

Known issues

No new issues have been observed in this release.

2305

What’s new

Support for horizontal scroll

Previously, Citrix Workspace app for Mac supported only vertical scroll on a trackpad. Starting with the 2305 version, a horizontal scroll is also supported. For more information, see Support for horizontal scroll.

Improved audio echo cancellation support

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. For more information, see Improved audio echo cancellation support.

Improved graphics performance [Technical Preview]

Starting with the 2305 version, the performance of graphics is improved for seamless sessions. This feature also reduces the load on CPU usage.

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’s advised that Beta builds must not be deployed in production environments.

Support for Certificate-based authentication

Starting with the 2305 version, Workspace administrators can configure and enforce Azure Active Directory conditional access policies for users authenticating to Citrix Workspace app.

The following methods can be used to enable the authentication using conditional access:

  • Mobile Device Management (MDM)
  • Global App Configuration service (GACS)

The flag values read by Citrix Workspace app take precedence in the following order:

  • Mobile Device Management (MDM)
  • Global App Configuration service (GACS)

For more information, see Support for Certificate-based authentication.

Channel support for Global App Configuration service

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. Global App Configuration service now allows administrators to test the settings before rolling it out to all users. This feature allows to resolve any issues before applying the global app configurations to the entire user base. For more information, see Channel support for Global App Configuration service.

Improved auto-update experience

The auto-update feature automatically updates the Citrix Workspace app to the latest version without the need for any user intervention.

Citrix Workspace app periodically checks and downloads the latest available version of the app. Citrix Workspace app determines the best time to install based on user activity not to cause any disruptions.

For more information, see Improved auto-update experience.

Opened apps appear in the dock with native app icons

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 are opened in the Citrix Viewer. You can view the open apps by right-clicking the Citrix Viewer icon.

Viewer grouping

Starting with the 2305 version, when you open virtual apps, they appear in the Dock (bottom-right corner of the screen) 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 aren’t duplicates in the Dock but are grouped within one instance in the Dock.

Dock grouping

For more information, see the Opened apps appear in the dock with native app icons page.

Improved Mission Control and App Expose experience

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 the 2305 version, 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

For more information, see Improved Mission Control and App Expose experience.

Enhancement to sleep mode for optimized Microsoft Teams call

Previously, when using the optimized Microsoft Teams meeting, if there’s no mouse or keyboard interaction, Citrix Workspace app or the optimized Microsoft Teams screen might go to sleep mode.

Starting with the 2305 version, Citrix Workspace app or the optimized Microsoft Teams screen doesn’t go to sleep mode even if there’s no mouse or keyboard interaction during an optimized Microsoft Teams meeting.

For more information, see Enhancement to sleep mode for optimized Microsoft Teams call.

Support for continuity camera

With the Continuity Camera, you can now use the iPhone as your webcam. For a seamless connection, mount your iPhone such that its camera is available to the Mac device. You must select Webcam > Automatic Camera Selection for the iPhone to appear automatically on the Mac device as an external camera. You can switch to any other camera manually, for example by selecting Webcam > FaceTime HD Camera. The Continuity Camera works wired or wirelessly and provides a high-quality image. For more information, see Support for continuity camera.

Increase in the number of supported virtual channels [Technical Preview]

In earlier versions of the client, sessions supported up to 32 virtual channels. Starting with the 2305 version, you can use up to 64 virtual channels in a session.

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’s advised that Beta builds must not be deployed in production environments.

Store-based configuration of microphone and webcam access levels [Technical Preview]

Starting with the 2305 version, the per-store microphone and webcam access are included as a part of the client-selective trust feature. This enhancement allows you to change the settings based on a per-store basis. You can click a store to enable the required microphone or camera access. The selected setting for microphone or camera access is applied on a per-store basis.

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’s advised that Beta builds must not be deployed in production environments.

Support for authentication using FIDO2 when connecting to cloud stores [Technical Preview]

Starting with the 2305 version, users can authenticate using passwordless FIDO2 security keys when connecting to Citrix Workspace app for Mac. Users can sign into the cloud stores using the FIDO2 security keys. The security keys support different types of security inputs such as security pins, biometrics, card swipe, smart card, Public Key Certificates. This feature is supported on macOS 12 and later versions. For more information about FIDO2 see FIDO2 Authentication.

Citrix Workspace app uses the user’s default browser for FIDO2 authentication (Webauthn). Administrators can configure the type of browser to authenticate to Citrix Workspace app. The configured setting can be pushed using the Mobile Device Management (MDM), Global App Configuration service (GACS), or the command line interface methods. The FIDO2 feature is not supported for on-premises stores. For more information on the web browser settings, see Global App Configuration service documentation.

The following settings allow you to select the type of browser used for authenticating an end user into Citrix Workspace app:

Embedded: Allows you to authenticate within Citrix Workspace app. Citrix Workspace app saves the session data or cookies for single sign-on (for example, SaaS apps) when the enhanced single sign-on feature is enabled. This authentication method does not support passwordless authentications such as FIDO2.

EmbeddedWithPrivateSession: This setting is similar to the Embedded setting. Single sign-on isn’t supported as session data or cookies aren’t present in Citrix Workspace app.

System: Allows you to use the user’s default browser for authentication (for example, Safari or Chrome). Authentication occurs outside Citrix Workspace app. Use this setting to support passwordless authentication. This setting tries to use the existing user session from the user’s browser.

SystemWithPrivateSession: This setting is like the System setting. Citrix Workspace app uses a private session in the browser for authentication. The browser doesn’t save authentication cookies or data. Single sign-on isn’t supported in this option.

Enabling authentication using MDM

To enable authentication through MDM, administrators must use the following settings:

<key>WebBrowserForAuthentication</key> <string>System</string>

Enabling authentication using GACS

To enable authentication through GACS, administrators must use the following settings:


{
    "serviceURL": {
      "url": "https://serviceURL:443"
    },
    "settings": {
      "name": "Productivity Apps",
      "description": "Provides access to MS Office and other basic apps",
      "useForAppConfig": true,
      "appSettings": {
        "macos": [
          {
            "assignedTo": [
              "AllUsersNoAuthentication"
            ],
            "category": "authentication",
            "settings": [
              {
                "name": "web browser for authentication",
                "value": "SystemWithPrivateSession"
              }
            ],
            "userOverride": false
          }
        ]
      }
    }
  }

<!--NeedCopy-->
Enabling authentication using the command-line interface

To enable authentication using the command-line interface, administrators must run the following command:

defaults write com.citrix.receiver.nomas WebBrowserForAuthentication System

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 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 must not be deployed in production environments.

Keyboard input mode enhancements

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 the 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 input mode enhancements.

Citrix Enterprise Browser

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

Modification in SPA policy implementation on internal Web and SaaS apps

This feature enhances the security policies implementation on Web and SaaS apps. When a webpage and iframes within the webpage have different policies, we now have a stricter policy implementation where a union of all policies is applied on the entire webpage, including the iframes. However, the watermark is applied to the webpage only.

Support for browser extensions

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.

For information on how to configure, see the Support for browser extensions documentation.

Use GACS to manage Citrix Enterprise Browser

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

The GACS is designed for administrators to easily configure Citrix Workspace and manage the Citrix Workspace app settings. This feature allows admins to use GACS 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 APIs or the GACS Admin UI:

  • “Enable CEB 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 the 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 uses the Chrome Web Store.

For more information, see Use Global App Configuration service to manage Citrix Enterprise Browser.

Notes:


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

<!--NeedCopy-->
User interface

To configure Citrix Enterprise Browser through the GACS Admin UI, do the following:

  1. Sign in to citrix.cloud.com with your credentials.

    Note:

  2. Upon authentication, click the menu button in the top left corner and select Workspace Configuration.

    Menu

    The Workspace Configuration screen appears.

  3. Click App Configuration > Citrix Enterprise Browser.

    Breadcrumbs

    You can now configure, modify, and publish Citrix Enterprise Browser feature settings.

For more information, see Use Global App Configuration service to manage Citrix Enterprise Browser.

Technical Preview

  • Client APP Management

For a complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

  • With this enhancement, the location data can be collected and sent to Microsoft Teams to support the dynamic emergency calling feature. [CVADHELP-21117]

  • When you scroll in a MacBook using a touchpad in a user session that is opened through Citrix Workspace app for Mac, the scroll experience might not be smooth. [CVADHELP-21427]

  • When using Citrix Workspace app for Mac, external users might get disconnected from the sessions intermittently. [CVADHELP-22191]

  • Attempts to add a store URL that contains a query parameter might fail in Citrix Workspace app for Mac with this error message:

    This store doesn’t exist. Please retry or contact support.

    [CVADHELP-22445]

  • On an on-premises store, when you attempt to open Citrix Workspace app from the Menu bar, you might experience an indefinite wait time. [CVADHELP-22688]

2304

What’s new

Enhanced auto start experience

Previously, Citrix Workspace app for Mac used to start automatically whenever a computer was turned on. Starting with the 2304 version, you can choose to disable or enable the auto start feature on Citrix Workspace app for Mac by navigating to Preferences > General > Start Workspace on system startup. The auto start setting is enabled by default.

Auto start

For more information, see Enhanced auto start experience.

Improved experience for optimized Microsoft Teams video conference calls

Starting with the 2304 version, by default simulcast support is enabled for optimized Microsoft Teams video conference calls. With this support, the quality and experience of video conference calls across different endpoints are improved. It is achieved by adapting to the proper resolution for the best call experience for all callers.

With this improved experience, each user might deliver multiple video streams in different resolutions (for example, 720p, 360p, and so on) depending on several factors including endpoint capability, network conditions, and so on. The receiving endpoint then requests the maximum quality resolution that it can handle thus giving all users the optimum video experience.

Note:

This feature is available only after the roll-out of an update from Microsoft Teams. For information on ETA, go to https://www.microsoft.com/ and search for the Microsoft 365 roadmap. When the update is rolled-out by Microsoft, you can check CTX253754 for the documentation update and the announcement.

For more information see, Improved experience for optimized Microsoft Teams video conference calls.

Support for Certificate-based authentication [Technical Preview]

Starting with the 2304 version, Workspace administrators can configure and enforce Azure Active Directory conditional access policies for users authenticating to Citrix Workspace app.

The following methods can be used to enable the authentication using conditional access:

  • Mobile Device Management (MDM)
  • Global App Configuration service (GACS)

The flag values read by Citrix Workspace app take precedence in the following order:

  • Mobile Device Management (MDM)
  • Global App Configuration service (GACS)

For more information, see Support for Certificate-based authentication.

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’s advised that Beta builds must not be deployed in production environments.

Force login prompt for Federated identity provider

Citrix Workspace app now honors the Federated Identity Provider Sessions setting. For more information, see Citrix Knowledge Center article CTX253779.

You no longer need to use the Store authentication tokens policy to force the login prompt. For more information, see Force login prompt for Federated identity provider.

Support for non-English-language Input Method Editors (IME) keyboard layouts

Support for non-English language IME keyboard layouts continues to work uninterrupted after the Carbon APIs are deprecated with the Cocoa APIs. For more information, see Support for non-English-language Input Method Editors (IME) keyboard layouts.

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. Users can now collect logs quickly by using the new option provided in the Help menu by navigating to Help and selecting the Logging… or Email Log Files option. This feature improves the user experience during the log collection process.

Dock Rapid scan

  • Logging… - clicking this option directs you to Preferences > Advanced > Logging
  • Email Log Files – clicking this option allows collecting the latest logs.

For more information, see Log collection.

Support synchronization for more keyboard layouts

Starting with the 2304 version, Citrix Workspace app for Mac supports keyboard layout synchronization for the following layouts or Input Method Editors (IMEs):

  • English ABC
  • English ABC - India
  • Chinese, Traditional: Zhuyin - Traditional
  • Chinese, Traditional: Sucheng - Traditional
  • Google Japanese IME
  • Sougou Chinese IME

For more information, see Support synchronization for more keyboard layouts.

Microsoft Teams enhancement

Configuring a preferred network interface

You can now configure a preferred network interface for media traffic. Run the following command in a terminal:

defaults write com.citrix.HdxRtcEngine NetworkPreference -int <value>

Select one of the following values as required:

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

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

For more information, see Configuring a preferred network interface.

Limiting video resolutions

Administrators with users on lower-performance client endpoints can limit incoming or outgoing video resolutions to reduce the impact of video encoding and decoding on those endpoints. Starting from Citrix Workspace app 2304 for Mac, you can limit these resolutions using client configuration options.

For more information, see Limiting video resolutions.

Support for horizontal scroll [Technical Preview]

Previously, Citrix Workspace app for Mac supported only vertical scroll on a trackpad. Starting with the 2304 version, a horizontal scroll is also supported.

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’s advised that Beta builds must not be deployed in production environments.

Keyboard input mode enhancements

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 the 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 input mode enhancements.

Citrix Enterprise Browser

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

Technical Preview

  • Rapid Scan
  • Enhanced virtual apps and desktops launch experience
  • Support for multiple audio devices

For a complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

  • When you create two XML files on a Mac local client, the VDA might open the incorrect XML file. For example, the VDA opens the Snapshot.xml file instead of opening the SnapshotPopup.xml file. [HDX-45326]

  • When you change the active audio devices in the sound settings on the endpoint, Microsoft Teams might not receive any notification about the change. As a result, Microsoft Teams fails to pick the changes. [HDX-47080]

  • The Citrix Viewer might quit occasionally when you close a VDA session. [HDX-45668, HDX-47138]

  • The responder policy configured using Citrix ADC might fail to work with Citrix Workspace app for Mac. The issue occurs when the policy configured checks if the user agent has sent CWAWEBVIEW, Citrix Receiver, or Citrix Workspace as a substring, which does not match. As a result, users might be redirected to a different Citrix Gateway URL. [CVADHELP-20519]

  • When you connect to Citrix Gateway Store and attempt to sign in to Citrix Workspace app for Mac, the sign-in might get stuck or take time with a spinning wheel. [CVADHELP-21323]

  • Citrix Workspace app for Mac might fail to start a session if the File Type Association is set for an app under Application Settings in Citrix Studio. [CVADHELP-21371]

  • A sign-in window might appear automatically in Citrix Workspace app for Mac when you power on or restart your system. [CVADHELP-21484]

  • Citrix Workspace app for Mac might quit unexpectedly when the Universal Windows Platform (UWP) apps within the VDI attempt to authenticate using the FIDO2 authentication. [CVADHELP-21576]

  • Attempts to open the web resources might fail with this error message:

    Switch to another store with the necessary permissions. If the issue persists, contact your admin with error details.

    [CVADHELP-21787]

  • Citrix Workspace app for Mac might use an incorrect user agent CitrixReceiver instead of Citrix Workspace as a substring. As a result, the authorization policies aren’t honored. [CVADHELP-21969]

  • When using the notch screen feature, a part of the text might be cut. [CVADHELP-22134]

  • When you open Citrix Enterprise Browser from the dock, instead of a new tab, it shows that the page is loading. As a workaround, enter the URL in the address bar or open another tab to continue browsing. [CTXBR-4706]

  • When using the Citrix Secure Private Access enabled store, an infinite loading spinner might appear while launching the published content. The issue occurs when Citrix Enterprise Browser isn’t running on the user device. As a result, you can’t view the published content. [CTXBR-4813]

2301.1

What’s new

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

Fixed issues

  • You might face issues when you add or authenticate a store, or start a resource (apps or desktops) using the native Citrix Workspace app. [CVADHELP-22372]

  • The incoming video and screen sharing might not work during Microsoft Teams optimized video calls. [HDX-50059]

Known issues in 2301.1

  • You can’t update to Citrix Workspace app for Mac version 2301.1 using the auto-update service. As a workaround, you must manually install the Citrix Workspace app for Mac version 2301.1 by downloading the .dmg file available on the Downloads page.

2301

What’s new

Background blurring and replacement for Citrix Optimized Microsoft Teams

Citrix Optimized Microsoft 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 Configuration service.

Example JSON file in Global App Configuration service:


{
  "serviceURL": {
    "url": "https://serviceURL:443"
  },
  "settings": {
    "name": "Version Control for Citrix Workspace",
    "description": "Provides admin ability to Version Control for Citrix Workspace",
    "useForAppConfig": true,
    "appSettings": {
      "macos": [
        {
          "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": "23.04.0.36",
                    "maximumAllowedVersion": "23.04.0.36",
                    "delayGroup": "Medium",
                    "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 Configuration service.

Note:

  • To enable auto-update version control, the upgradeToLatest setting in the Global App Configuration service must be set to false. If the upgradeToLatest setting is true, the maximumAllowedVersion and minimumAllowedVersion is ignored.
  • Do not modify the pluginId. The pluginId is mapped to Citrix Workspace app.
  • If the administrator hasn’t configured the version in the Global App Configuration 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, a downgrade isn’t 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 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 must 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 your admin disable the automatic updates.

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 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 must not be deployed in production environments.

Enhanced notch screen support

Starting with the 2301 version, Citrix Workspace app for Mac supports Macs with a notch display. Macs support a native notch screen in full screen mode for retina and multi-monitor displays. The area of the session in the 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. For more information, see Enhanced notch screen support.

Note:

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

App Protection enhancement

Starting with the 2301 version, 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.

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 Configuration service to define settings, which are applicable to specific user-groups. This feature 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 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 must not be deployed in production environments.

Enhanced menu bar support

Starting with the 2301 version, 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 clear 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 clear 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. For more information, see Enhanced menu bar support.

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 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 the administrator configures 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 any other browser that the end-user selects.

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

Fixed issues

  • HTTP Live Streaming (HLS) protocol with High-Efficiency Advanced Audio Coding (AAC-HE) stream fails to play back 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 the 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]

2211.1

What’s new

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

Fixed issues

  • You might face issues when you add or authenticate a store, or start a resource (apps or desktops) using the native Citrix Workspace app. [CVADHELP-22372]

  • The incoming video and screen sharing might not work during Microsoft Teams optimized video calls. [HDX-50059]

2211

What’s new

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

Starting with the 2211 version, 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 the 2211 version, 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 Citrix Enterprise Browser documentation.

Fixed issues

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

2210

What’s new

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 version, when you download the Universal Architecture build, you can choose 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 Configuration 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 version, 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 aren’t 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 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 must 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 version, 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 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 must not be deployed in production environments.

Improved graphics performance [Technical preview]

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

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’s advised that Beta builds must not be deployed in production environments.

Support for high DPI

Citrix Workspace app for Mac is now compatible with one high DPI monitor with 4K or 5K resolution. With this feature, the text, images, and other graphical elements on virtual desktop or app sessions appear in a size that can be viewed comfortably on these high-resolution monitors. For more information, see Support for high DPI.

To enable this feature, navigate to Preferences > General > High DPI.

High DPI

Note:

The number of external monitors you can use with your mac is always limited by the Mac model, as well as the resolution and refresh rate of each display. Refer to the technical specifications of your Mac to find out the supported number of external monitors. For more information, see Connect one or more external displays with your Mac in the Apple support article.

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.

For more information, see Mobile Device Management

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 the 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 aren’t 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 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 must 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’s 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 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 version, 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 the Citrix Enterprise Browser documentation.

Use Global App Configuration 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 CEB 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 the 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 uses 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-->

Technical Preview

  • Upgraded version of WebRTC for the optimized Microsoft Teams

For a complete list of Technical Preview features, see the Features in Technical Preview page.

Fixed issues

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

2209

What’s new

Sign out of the 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. For more information, see Sign out of the custom web store when you close Citrix Workspace app

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 Citrix Enterprise Browser documentation.

Fixed issues

  • 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

What’s new

View apps, desktops, and Citrix Enterprise Browser from the 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 isn’t available on on-premises setups.

Recent favorites

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 favorites

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 isn’t available if the configured store doesn’t have any web or SaaS apps. Further, it’s 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

For more information, see View apps, desktops, and Citrix Enterprise Browser from the menu bar through a quick access menu.

Support for authentication using FIDO2 [Technical Preview]

With this version, users can authenticate within an HDX session using password-less 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 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 must 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.

For more information, see Battery status indicator.

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 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 version, 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’s advised that Beta builds aren’t deployed in production environments.

Fixed issues

  • 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

What’s new

Uninstall the 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 version, 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.

For more information, see Uninstall

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 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 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 must 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. For more information, see Enhancements to Optimized Microsoft Teams

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 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 are not 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 Citrix Enterprise Browser documentation.

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 peers 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

What’s new

Global App Configuration service settings for allowedWebStoreURLs

Admins can now use Global App Configuration 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 one high DPI monitor with 4K or 5K resolution. With this feature, the text, images, and graphical elements on virtual desktop or app sessions appear in a size that can be viewed comfortably on these high-resolution monitors.

To enable this feature, navigate to Preferences > General > High DPI.

High DPI

Administrators 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 one high DPI monitor with 4K resolution.

For virtual app sessions, the default value of Display memory Limit is sufficient as the app session doesn’t support more than one display.

For virtual desktop sessions, administrators must navigate to Citrix Studio > Policies > Display memory limit and use a higher value, for example 393216 KB to use High DPI features for more than one external monitor or 5K resolution monitor.

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

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’s advised that Beta builds aren’t deployed in production environments.

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

With this version, if you’re 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 lines in the [WFClient] section:

isRDSLicensingEnabled=On

Restore default keyboard settings

You can now restore the default keyboard settings if you have modified the settings in the keyboard preferences of Citrix Workspace app. 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 version, 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’re 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 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 peers 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]

Known issues

Known issues in 2308

  • After upgrading Citrix Workspace app for Mac to version 2308, the preferences window might be unresponsive for any user actions. As a workaround, force quit Citrix Workspace app and restart it. For more information about forcing an app to close on a Mac, see Force an app to close in the Apple support article. [RFMAC-14596]

Known issue in 2307

No new issues have been observed in this release.

Known issue in 2306

No new issues have been observed in this release.

Known issues in 2305

  • After upgrading Citrix Workspace app for Mac to version 2305, certain third-party virtual apps that have pop-up dialogs for entering user name and password might become unresponsive upon opening. [CVADHELP-23032]

Known issues in 2304

  • A user with multiple accounts might see the Citrix Workspace app loading screen for a long time. As a workaround, you must quit Citrix Workspace app and restart it. [RFMAC-13432]

Known issues in 2301.1

  • You can’t update to Citrix Workspace app for Mac version 2301.1 using the auto-update service. As a workaround, you must manually install the Citrix Workspace app for Mac version 2301.1 by downloading the .dmg file available on the Downloads page.

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’re using the keyboard, press the Ctrl key and click the app. Select Open. [CTXBR-3885]

  • An infinite loading spinner might appear when users sign in to Citrix Workspace associated with Global App Configuration service. This issue doesn’t impact StoreFront and custom web stores. [RFMAC-13086]

Known issue in 2211.1

No new issues have been observed in this release.

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 the 2210 version, 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 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 if the browser window is minimized. [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 upgrading Citrix Enterprise Browser from version 2201 to version 2203, you are unable to save new passwords and already saved passwords are lost. [CTXBR-3063]

  • Full screen mode isn’t 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’re 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’ve 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’re 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’re 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 aren’t 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]

Deprecation

For information about deprecated items, see the Deprecation page.

Legacy documentation

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

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