29-04-2021



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.

By default, Citrix Receiver for Web sites automatically attempt to determine whether Citrix Workspace app is installed when accessed from computers running Windows or Mac OS X. If Citrix Workspace app cannot be detected, the user is prompted to download and install it for their platform. When connecting to Citrix from a laptop or desktop computer, it is possible to use the webcam, speakers, and microphone built into the device. In order to do this, you must first grant Citrix access to the devices. Start by getting logged into Citrix. Citrix Receiver 10.9.5 Update To Receiver; Citrix Receiver 10.9.5 Upgrade Has Changed; Citrix Receiver 10.9.5 Upgrade Has Changed. Would end up being good to possess this set in 10.9.5 nevertheless 10.9.5 all you need to perform as I possess discovered is usually get the concentrate off the citrix customer and go back.

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_IDBrief Description of IssueBrief Description of FixApplicable Product Versions Affected (if known)Link to supplemental Support Article(s)
1Bloomberg 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
2Windows 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
3When 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
4If using a proxy connection, communication over EDT fails.This is a known issue.Receiver for Mac 12.5.
5You 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.
6Delivering 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
7When 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
8French 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
9Alt+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
10When 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
downloadWhy can't I download this file? Need Citrix Files for Mac? Download it here: https://dl.sharefile.com/cfmac


Citrix Files makes accessing your files from a Mac much easier. It allows you to access files and folders from ShareFile directly through Finder on your Mac. Content is streamed when it is accessed and not permanently stored on your computer. Changes made to files in the ShareFile folder are automatically saved back to the cloud. Most Finder operations like drag and drop, copy and paste, move and rename, and others will automatically update to the cloud.

Contents

System Requirements
Install Citrix Files
Sign-in to Citrix Files
Basic Operations

Icon Overlays
Right Click Menu
Menu Bar Icon
Dashboard
Overflow Menu
Preferences
Open and Edit
Conflict Prevention
Troubleshooting

Citrix Files Drive is Unavailable
Reconnect the Drive
Relaunch Citrix Files
Reinstall Citrix Files

System Requirements

  • macOS 10.12 Sierra
  • macOS 10.13 High Sierra
  • macOS 10.14 Mojave
  • macOS 10.15 Catalina
Note:
  • Installation on macOS 10.11 El Capitan is possible, but Citrix no longer supports this version.
  • Apple’s latest macOS 10.15 Catalina was released on October 7, 2019. Upgrade to Citrix Files for Mac version 19.10 or above for full compatibility.

Install

  1. Download the installer DMG.
  2. Open the installer package and follow the prompts to install Citrix Files.
  3. You will be required to provide an administrator password and accept prompts for mounting the Citrix Files kernel extension to complete the installation.
Note: Citrix Files for Mac support for Apple silicon devices (M1 chip) is on a preview basis. Please see macOS Recovery security setting requirements that 'Allow user management of kernel extensions from identified developers.'


After installation, a volume named “Citrix Files” will appear. You may access this volume by clicking on the Citrix Files menu bar item and then clicking the folder icon. It will also appear in the Favorites sidebar in Finder windows. This volume displays all of the files and folders from your Citrix Files account.

Sign in

When starting the Citrix Files Desktop app for the first time, you are prompted to sign in with your Citrix Files Credentials.

Basic Operations

Citrix Files allows you to manage the files in your Citrix Files account the same way that you would manage files normally through Finder.

OperationDescription
Open and Edit

Double click on a file in the Citrix Files folder. Make any edits necessary and then save the changes.


Citrix Files uploads the edited file.

Download

Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer.


You may also copy and paste files and folders.

Upload

Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer.
You may also copy and paste files and folders.

DeleteRight click on a file or folder and select Move to Trash.
You may also drag files and folders to the trash.
Move

Drag and drop file(s) or folder(s) from one location in the Citrix Files folder to another.

New FolderCreate a new folder in Citrix Files folder.

Quick Tip:
The new local storage folder selection feature: Storage Folder
Recently accessed files and files made available offline are stored in a cache folder for fast access. In most cases, there is no need to change this location. Some users with hard drive partitions may wish to store cache data on another partition. You may change the folder where the cache is stored by clicking storage folder.

  • The cache folder is named 'SFDriveMapper'. Please use the preferences menu to free up or remove data instead of deleting content directly.
  • Choose a location that will always be available (an external hard drive is not recommended) -When you switch locations, the app will move data already in the cache to your new location.


Icon Overlays

Files and Folders will have an icon overlay representing the status of that item. The following defines what each icon overlay represents:

Iweb

Online-only files. These folders and files don’t take up space on your computer.
Note: You may not open online-only files / folders when your device isn’t connected to the Internet.

Mixed state Folder occurs when you have some items within it are mixed across online-only, always offline and/or cached.

Note: When you open an online-only file, it is download to your device and becomes a cached file. You can open cached files anytime, even without internet access. If you need to free up space, you can change the file back to online only. To do so just right-click the file and select ‘to be set’ or go to the Citrix Files dashboard – settings – free up space

Only files or folders that you mark as “Make available offline” will have a green circle with the white check mark. These files or folders are downloaded to your device and are available offline.
Note: To bring these files or folders back to online-only, you need to right-click on the file or folder and select “Make available online.”

The file or folder is currently syncing to the cloud.
Note: This means upload and downloads are currently in progress.

The file is currently checked out.

Right Click Menu



When you right click on a file or folder within Citrix Files, you will see some additional options. These options give you access to the functions available in Citrix Files for these items. Options will vary based on the types of files or folders you have selected, permissions, and account settings.

OperationAvailable ForDescription
ShareFiles and FoldersCopy Link - Copies a Citrix Files download link. Link settings will be determined by the Share options in your Preferences.
Email with Citrix Files - Send a download link through email. Email options may be customized before sending, or by modifying default options in your Preferences.
Email with mail app - Opens the Mail app in Mac OS. A new message is generated that contains a Citrix Files download link
Initiate Approval - (For a single file only) Initiate an approval workflow on a file
Request FilesSingle FolderCopy Link - Copies a Citrix Files upload link. Link settings will be determined by the Share options in your Preferences.
Email with Citrix Files - Send a upload link through email. Email options may be customized before sending, or by modifying default options in your Preferences.
Email with mail app - Opens the Mail app in Mac OS. A new message is generated that contains a Citrix Files upload link
Check OutSingle FileCheck Out a file to prevent other users from making changes
View DetailsSingle File or FolderView detailed information for a file or folder. The details window provides access to multiple file versions, notes, or checkout details
Refresh ContentsSingle FolderFolder contents should update automatically as changes are made, but you may refresh contents manually using this function
Citrix receiver app for mac

Additional actions are available under More Options.

Web Mac Games

OperationAvailable ForDescription
DownloadFiles and FoldersFor file(s) and folder(s), download allows you to download file(s) or folder(s) to a specific location on your computer.
Note: For improved performance, use this option for large file downloads or downloading a large number of items. These downloads are optimized for bulk operations and do not store data in the cache.
UploadSingle FolderRight click on a folder and upload allows you to upload files and folders from a specific location on your computer.
Note: For improved performance, use this option for large file uploads or uploading a large number of items These downloads are optimized for bulk operations and do not store data in the cache.
Manage PermissionsSingle FolderAdd users to a folder, modify folder permissions, and copy folder permissions from one user to another.
Add to FavoritesSingle File or Single FolderAdds the file or folder to the Favorites folder.
PreviewSingle FileStream a video file without downloading it (Available for .mp4, .ogg, .ogv, and .webm file types).

Menu Bar Icon

This icon displays the current status of Citrix Files. A spinner over the icon indicates activity.
Uploads in progress or edits that are being saved back to Citrix Files will be indicated by a spinner. You will also see a spinner when navigating to a folder. The spinner indicates that the contents of a folder are being fetched and should appear after the spinner disappears.


Dashboard

Clicking on the menu bar icon will open the dashboard:

  • Recent Files - Files that have been uploaded or edited will appear in the list of recent files. Double click on a file to open it.
  • Overflow Menu - Access Preferences, Send Feedback, Help Launch Website, and quit/exit the Citrix Files application.
  • Workflow button - Open a window containing Workflows where you can view
  • Open Citrix Files Folder - Open the Citrix Files drive in Finder on this Mac.

Overflow Menu

This provides access to Preferences, Send Feedback, Help Launch Website, and Quit.


Provide a rating for the app and leave detailed comments.

  • Help - Provides links to support and legal resources. This menu also allows you to report a technical problem with the app to the development team.
  • Launch Website - Opens the Citrix Files website.
  • Quit - Quits the App.
  • Preferences - Opens the Preferences for the App.

Preferences

Preference

Description

Account

Log out - Logs you out of your account. Cached files are deleted

App Settings

Cache - Hover over the ? for details and cache usage
Clear Cache - This removes ached files
Reset App settings - Removes folder structure archive and cached files. Doing this will quit and relaunch Citrix Files for Mac to please save any work before resetting.
Uninstall - This uninstalls the application. Administrator permissions are required.

Share Options

Notifications - Set default notifications that are applied when sharing
Security - Set default security options that are applied when sharing

Open and Edit

Open and Edit has been tested with the following applications:

  • Adobe Acrobat Reader DC
  • Adobe Photoshop
  • Keynote
  • Numbers
  • Microsoft Excel 2008, 2011, 2016, 2017
  • Microsoft PowerPoint 2008, 2011, 2016, 2017
  • Microsoft Word 2008, 2011, 2016, 2017
  • Pages
  • Preview
  • Sketch
  • TextEdit

Other applications will be tested and fully supported during the course of the Beta program. Please report any issues you experience with open and edit.
Users are welcome to use Citrix Files for Mac with any application, however when using applications that are not listed above, we recommend saving local copies before uploading to Citrix Files until compatibility has been tested.

Conflict Prevention

Citrix Receiver Web Plugin Mac

Citrix Files for Mac provides end user notifications when another user uploads a new version of a file or checks a file out while you are also viewing / editing the file, in order to prevent file conflicts.
Notification when someone uploads a new version of the file you also have open:
Notification when someone checks out a file while you also have that file open:

Troubleshooting

Citrix Files Drive is Unavailable

Citrix Files gives you access to the files on your Workspace account by making them available as a storage drive (like an SD card or a thumb drive). This drive needs to mount itself into your Mac's file system before files can be accessed from Citrix Files. If the Citrix Files app experiences an issue with mounting, the app menu bar icon will show a warning symbol. You will need to ensure the drive mounts properly before you may use Citrix Files.

Reconnect the Drive

Citrix Receiver Web Application

  1. Click the Citrix Files menu bar icon.
  2. Click Reconnect.

Relaunch the App

Citrix Receiver Web Latest Version

You may need to relaunch Citrix Files app in case the app experiences an issue with mounting.

  1. Close any files that may be open in Citrix Files (Ex: You have opened a Word document in Citrix Files).
  2. Click on the Citrix Files menu bar icon.
  3. Click on (...).
  4. Select Quit.
  5. Open Citrix Files app in your Applications folder.

Reinstall Citrix Files

Citrix Receiver Web App

Citrix Files installs a kernel extension or ext to mount the drive.

  1. Click the Citrix Files menu bar icon.
  2. Click on (...) Over Flow Menu
  3. Select Help.
  4. Click Uninstall Citrix Files.
  5. Download and install Citrix Files again.

Additional Resources

CTX237344 - Citrix Files for Mac Known Issues
CTX119253- Language Support for Citrix Products