A list containing the majority of Citrix Workspace app for Mac (formerly Receiver for Mac) support articles collated to make this page a one stop place for you to search for and find information regarding any issues you have with the product and its related dependencies.
The page is updated daily with new support articles and information. Articles will change from time and if information here is outdated or incorrect please let me know using the comments. Links may also expire or change so if you find broken links, please again let me know. For each issue, known product versions affected are recorded however that does not mean product versions that aren’t listed are not affected.
There is a search box that you can use if looking for a specific fault. For example if you have an error code or error message, use that to perform a search. You can also use your browsers search feature which will perform a search against the whole page based on the words you enter.
Receiver for Mac / Workspace app for Mac:
| wdt_ID | Brief Description of Issue | Brief Description of Fix | Applicable Product Versions Affected (if known) | Link to supplemental Support Article(s) |
|---|---|---|---|---|
| 1 | Bloomberg keyboard and finger print scanner not redirecting to Citrix session. | Redirection of this device is not fully supported but there is a method to follow that can be tried to get it working, as explained in the CTX article. | https://support.citrix.com/article/CTX227075 | |
| 2 | Windows Mac users connect to NetScale full VPN, they cannot reach external websites. Split DNS is not working. | This is by design. The Mac VPN client does not support split DNS so all DNS requests are sent to NetScaler for resolution. If NetScaler cannot resolve the domain name then users will get an invalid response. This issue will be fixed under an existing enhancement request. | https://support.citrix.com/article/CTX225297 | |
| 3 | When using HDX 3D Pro, a black box may appear around some custom cursors. | This is a known issue and 32-bit cursors are being investigated as part of the product road maps for Citrix Receiver for Mac. Cursors that employ shadow effects for example are classed as 32-bit cursors and not currently supported by Receiver for Mac. | https://support.citrix.com/article/CTX223626 | |
| 4 | If using a proxy connection, communication over EDT fails. | This is a known issue. | Receiver for Mac 12.5. | |
| 5 | You receive an "Initialization failed" error. | This is caused by an upgrade to macOS Sierra. Upgrade to Receiver for Mac 12.3 which is compatible with this OS. | ||
| 6 | Delivering a proxy.pac file to clients via NetScaler Session Policies works for Windows devices but now Mac. | At the moment, only Windows devices are supported. Proxy PAC support for MacOS is currently being worked on. | https://support.citrix.com/article/CTX227262 | |
| 7 | When launching an application or desktop you may receive error "System Extension Blocked". | A new feature introduced to MacOS High Sierra requires user approval to load any newly-installed third-party kernel extensions. Navigate to "System Preferences -> Security & Privacy" and click "Allow" against "Citrix Systems Inc". | Citrix Receiver for Mac 12.7 and above, and MacOS High Sierra. | https://support.citrix.com/article/CTX228208 |
| 8 | French Canadian special accent characters do not display correctly when accessing a Windows 7 VDA. | Upgrade to Receiver for Mac 12.7. | Citrix Receiver for Mac 12.4. | https://support.citrix.com/article/CTX231623 |
| 9 | Alt+Tab does not switch properly all the time and Alt+Enter does not work in Excel. | Upgrade to Receiver for Mac 12.7. | Citrix Receiver for Mac 12.6. | https://support.citrix.com/article/CTX231624 |
| 10 | When using a DisplayLink docking station with v3.1 drivers and Receiver for Mac there is a high ICA RTT spike over 1000ms. | Upgrading to DisplayLink v4.0 drivers and MacOS 10.13 High Sierra resolves the issue. The issue is still being investigated for earlier MacOS versions. | Citrix Receiver for Mac 12.6 and 12.7. | https://support.citrix.com/article/CTX231625 |
| 11 | When you have Citrix Policy "HDX Adaptive Transport" set to "Preferred" and are connecting through NetScaler Gateway, you may experience your session disconnecting or the session launch displaying an SSL error when you try to disconnect and reconnect a session. | This is a known issue. Either disable SmartControl and HDXInsight on NetScaler, set disable HDX Adaptive Transport or upgrade to NetScaler 12.x. | Citrix Receiver for Mac 12.8 and Citrix NetScaler 11.1.51.x, 52.x, 53.x, 54.x, 55.x, 56.x. | https://support.citrix.com/article/CTX231557 |
| 12 | You may see error "Citrix Viewer may affect the performance of your Mac". | Citrix are working on developing a 64-bit version of Receiver for Mac | https://support.citrix.com/article/CTX232853 | |
| 13 | Receiver for Mac does not auto-update and when manually checking for updates you receive error "Problem checking for updates". | A TLS certificate was recently replaced on the Receiver Updates Service infrastructure which you need before you can again receive updates. Either download the certificate manually or wait until the next Receiver release. | Citrix Receiver for Mac 12.6 to 12.9. | https://support.citrix.com/article/CTX234657 |
| 14 | USB devices do not pass through to published desktops. | This is a known issue with Receiver for Mac 12.9 and is resolved in Workspace app for Mac 1808. | Citrix Receiver for Mac 12.9. | https://support.citrix.com/article/CTX237383 |
| 15 | When launching a published application hosted on VDA 7.6 from Receiver for Mac 12.7, 12.8 or 12.8.1, the window goes black when you have an external monitor. | Upgrade the VDA to 7.15. | https://support.citrix.com/article/CTX237372 | |
| 16 | Improper behaviour with published application window handling is observed. For example, when clicking on a button within a published application the active application window flips to another window instead of opening up a new menu. | Upgrade to Receiver for Mac 12.9. | Citrix Receiver for Mac 12.6. | https://support.citrix.com/article/CTX237374 |
| 17 | The RealTime Media Engine fails to install or enters an unoptimised state when you have the Workspace app for Mac installed. | Workspace app is 64-bit, and the RTME component is currently 32-bit. Citrix are working on releasing a 64-bit version of the RealTime Media Engine. | https://support.citrix.com/article/CTX237533 | |
| 18 | Files beginning with a . on Mac volumes do not show when connected to a Windows published desktop. | When connected to a Windows published desktop and sharing files from your Mac, there is no way to see files that names beginning with a period. | https://support.citrix.com/article/CTX237567 | |
| 19 | The Workspace app launcher is not able to automatically launch resources from Safari 12. This issue occurs after an upgrade to Safari 12. | Follow the CTX article steps to make changed to "web.config" on StoreFront so that Safari 12 is added to the list of browsers that the launcher will be used on. | https://support.citrix.com/article/CTX238286 | |
| 20 | Application windows switch to the background and cannot be brought to the foreground. | This issue is resolved in Workspace app for Mac 1808. | https://support.citrix.com/article/CTX238453 | |
| 21 | When connected to a VDA 7.15 LTSR CU2 machine, black boxes appear on the screen that represent applications that are minimised. | Upgrade to Workspace app for Mac 1809. | Citrix Receiver for Mac 12.9, 12.9.1 and Workspace app for Mac 1808. | https://support.citrix.com/article/CTX238912 |
| 22 | A USB device which redirects from Windows does not redirect from a Mac using Workspace app for Mac. | Create an allow rule for this device in "USB.conf" found under "/library/Application Support/Citrix Receiver/". | https://support.citrix.com/article/CTX239479 | |
| 23 | After upgrading to Safari 12, applications do not launch automatically when clicked. When you click to launch an application you receive message Do you want to allow this page to open "Citrix Workspace Launcher.app"?. | Uninstall Workspace app for Mac and reinstall it. | Safari 12. | https://support.citrix.com/article/CTX238285 |
| 24 | When running OS X 10.9.5 the keyboard is unresponsive when connected to a Citrix session. | Upgrade to Receiver for Windows 11.9 or later. | Mac OS X 10.9.5. | https://support.citrix.com/article/CTX200212 |
| 25 | After an upgrade to macOS Catalina, error "You have not chosen to trust "GlobalSign Root CA", the issuer of the server's security certificate" appears when launching an application through Workspace app. | Apple in Catalina have tightened the rules to trust certificates. All certificates that do not comply with new Apple certificate guidelines will be revoked in Catalina. Citrix have released a Tech Preview version of Workspace app which solves the problem. | Apple macOS Catalina. | https://discussions.citrix.com/topic/403432-citrix-workspace-app-globalsign-root-ca-post-upgrade-to-catalina-beta/ |
| 26 | Citrix sessions open in separate spaces, rather than the same desktop space the user is currently working on. | Setting "Assign to" as "none" through the Workspace app options menu solved this issue. | https://discussions.citrix.com/topic/403427-receiverworkspace-for-mac-opens-in-separate-desktop-spaces/ | |
| 27 | After an upgrade to VDA 1811, graphics appear distorted when using Excel as a published application. | When running VDA 7.16 the same problem does not occur. | https://discussions.citrix.com/topic/403503-desktop-session-graphic-rendering-issue/ | |
| 28 | Workspace app will randomly close with no error messages. | Upgrade to Workspace app 1906 for Mac. | https://support.citrix.com/article/CTX257647 | |
| 29 | Local printers connected to a Mac do not pass through to the Citrix desktop. | Setting "Default printer" to something other than "Last Printer Used" on the Mac allowed the chosen printer to pass through. | https://discussions.citrix.com/topic/404720-local-printers-not-mapping-up-with-mac-citrix-viewer-works-in-win-client/ | |
| 30 | Incomplete characters, black rows and other graphical distortions are experienced when using Excel as a published application. | Upgrade the VDA to LTSR 1912 CU1. | https://support.citrix.com/article/CTX272464 |
James L. Pertsch, M.D.
July 29, 2023Another problem not noted above:
The Citrix Workspace and Citrix Viewer opens filing the entire screen but doesn’t let me see the menus at the top and bottom of the window. So can’t access those menu bars at the very top and bottom of the Citrix screen to make selections, do work , etc.. Can’t grab the bottom right corner to resize the window. I’ve been told in the “PC world” a “scale and layout setting” may allow fix of this problem but cannot find equivalent on Mac. Nor could Apple support.
Please help. Thanks. DrP