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_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 |
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:
|
Install
- Download the installer DMG.
- Open the installer package and follow the prompts to install Citrix Files.
- 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.
| Operation | Description |
|---|---|
| Open and Edit | Double click on a file in the Citrix Files folder. Make any edits necessary and then save the changes.
|
| Download | Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer.
|
| Upload | Drag and drop file(s) or folder(s) from the Citrix Files folder to another folder on your computer. |
| Delete | Right 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 Folder | Create a new folder in Citrix Files folder. |
Quick Tip:
|
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. |
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. |
The file or folder is currently syncing to the cloud. |
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.
| Operation | Available For | Description |
|---|---|---|
| Share | Files and Folders | Copy 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 Files | Single Folder | Copy 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 Out | Single File | Check Out a file to prevent other users from making changes |
| View Details | Single File or Folder | View detailed information for a file or folder. The details window provides access to multiple file versions, notes, or checkout details |
| Refresh Contents | Single Folder | Folder contents should update automatically as changes are made, but you may refresh contents manually using this function |
Additional actions are available under More Options.
Web Mac Games
| Operation | Available For | Description |
|---|---|---|
| Download | Files and Folders | For 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. |
| Upload | Single Folder | Right 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 Permissions | Single Folder | Add users to a folder, modify folder permissions, and copy folder permissions from one user to another. |
| Add to Favorites | Single File or Single Folder | Adds the file or folder to the Favorites folder. |
| Preview | Single File | Stream 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 |
Share Options | Notifications - Set default notifications 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
- Click the Citrix Files menu bar icon.
- 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.
- Close any files that may be open in Citrix Files (Ex: You have opened a Word document in Citrix Files).
- Click on the Citrix Files menu bar icon.
- Click on (...).
- Select Quit.
- 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.
- Click the Citrix Files menu bar icon.
- Click on (...) Over Flow Menu
- Select Help.
- Click Uninstall Citrix Files.
- Download and install Citrix Files again.
Additional Resources
CTX119253- Language Support for Citrix Products