A list containing the majority of Citrix Workspace app for iOS (formerly Receiver for iOS) 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.
SaaS app support with Access Control. Citrix supports 50+ SaaS applications out-of-the box. The problem is those docs don't always work as every version of iOS 13 doesn't seem to include the.ICA file mapping to the Citrix Workspace app or Citrix Receiver app. In iOS 13.3, you can download the ICA file and it knows it is a Citrix Connection File, but tapping on it is not associated with launching Citrix Workspace or Receiver. Citrix Files for iOS allows you to browse files and folders from your Citrix Files account. Citrix Workspace App Workspace app for iOS Subscribe to RSS notifications of new downloads. Workspace app for iOS. Citrix Workspace app 20.12.0 for iOS.
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 iOS / Workspace app for iOS:
| wdt_ID | Brief Description of Issue | Brief Description of Fix | Applicable Product Versions Affected (if known) | Link to supplemental Support Article(s) |
|---|---|---|---|---|
| 1 | When launching any application you receive error 'Server error.; The server disconnected the session..'. | This could be caused by firewall port blockage either internally or externally via NetScaler. It could also be down to STA servers either not configured on NetScaler or down. | https://support.citrix.com/article/CTX225834 | |
| 2 | As you type into an application such as Word or Notepad, the virtual keyboard appears on screen. Eventually after several lines of text some of that text will begin to dissapear underneath the keyboard. | Citrix are aware of this issue and a solution is under investigation. | https://support.citrix.com/article/CTX223986 | |
| 3 | The keyboard does not automatically display and users have to manually select it to open. | Check the 'Automatic keyboard display' policy within Citrix Studio is set to 'Allowed'. | https://support.citrix.com/article/CTX220263 | |
| 4 | When logging on to NetScaler Gateway through Receiver for iOS you receive error 'The Gateway has Epa Enabled, which is not supported on iOS devices'. | Disable PNAgent Legacy Mode on the relevant StoreFront store by unchecking 'Enable XenApp Services support'. | https://support.citrix.com/article/CTX218712 | |
| 5 | When your password has expired and you change it through NetScaler Gateway, you receive error 'Incorrect Credentials'. | Ignore the error message as the password has been changed. This is a known issue and current limitation in Receiver for iOS 6.1.1. | Receiver for iOS 6.1.1. | https://support.citrix.com/article/CTX202427 |
| 6 | You receive the error message 'You have chosen not to trust ..., the issuer of the server's security certificate' when connecting to NetScaler Gateway. | Stricter certificate validation checks have been included in Receiver for iOS 7.2.2 and above versions. You must make sure that NetScaler provides the complete certificate chain to clients and that none of the certificates in that chain have expired. | Citrix Receiver for iOS 7.2.2. | https://support.citrix.com/article/CTX223949 |
| 7 | When using Receiver for iOS 7.3 or earlier on iOS 11, when authenticating to NetScaler or StoreFront with a Smart Card you receive error “Your smart card does not have a valid certificate”. Users running iOS 9 and 10 do not experience the same. | There is no workaround as yet. Citrix recommend you do not upgrade yet to iOS 11 if you use Smart Cards for authentication. | iOS 11. | https://support.citrix.com/article/CTX227952 |
| 8 | Smart Card users running Receiver for iOS 7.2.3 are unable to connect to VDA 7.13 applications and receive error “The operation couldn’t be completed (HdxSdkErrorDomain_Sessionerror 8)”. | Enable “Enhanced Desktop Experience” via Citrix policies. | https://support.citrix.com/article/CTX227966 | |
| 9 | Pinch and zoom does not work on iPad. | Disable the 'Citrix MultiTouch Redirection' service on the VDA. | https://support.citrix.com/article/CTX216604 | |
| 10 | 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 iOS 7.5 and Citrix NetScaler 11.1.51.x, 52.x, 53.x, 54.x, 55.x, 56.x. | https://support.citrix.com/article/CTX231557 |
downloadWhy can't I download this file?There are many differences when it comes to configuring the Citrix receiver for Windows and the Citrix receiver for iOS devices specifically the iPad/iPhone versions.
This article is going to go over the more common and new features/options the Citrix receiver for iOS has available along with screenshots, a brief description, and where they are located.
NOTE: This article applies to Citrix iOS versions 5.9 and above.
Features we will be going over are:
First you want to connect your external display in one of the following ways:
Now you are ready to enable the option in Citrix receiver. (This option is Disabled by default)
Settings > Display Options > External Display
Once the option has been enabled you should now be able to see what is on the iOS's devices screen on your external display.
If you wish to then use your iOS device strictly as a keyboard or a touchpad for maneuvering around your external display you simply need to enable Presentation Mode under External display (This option is Disabled by default)
Settings > Display Options > Presentation Mode
NOTE: The Presentation mode option only becomes available when External Display is enabled.
External display is not recommended on anything lower than an iPad-Air or iPhone 5c due to the amount of processing power required by the device.
Auto-Fit Screen - The Auto-fit Screen setting crops the session screen to the display size of iPhone. On iPad, Auto-fit Low/Medium/High will adjust the resolutions as 768x1024/1152x1536/1536x2048 and make applications and desktops fit the screen.
Settings > Display Options > Auto-fit Screen (on iPhone)
Settings > Display Options > Auto-fit Low/Medium/High (on iPad)
Extended Keyboard - is the ability to use all windows key combinations in your Citrix session that the iOS virtual keyboard does not provide for example the key combination Shift + F2 which is commonly used to break out of seamless windows and requires the use of the Windows function keys F1, F2, F3, etc…
Each individual keyboard combination can be enabled or disabled through the extended keyboard option. (Most of these combinations are Disabled by default)
Settings > Keyboard Options > Extended Keys
Use Custom Keyboards - this option is available for users who would like to use a full physical keyboard rather than the virtual keyboard of the iOS device and is typically connected with the devices Bluetooth pairing option. (This option is Disabled by default)
Settings > Keyboard Options > Use Custom Keyboards
NOTE: This feature when enabled since it is an external device as noted by the above pop-up message is less secure than using the iOS devices virtual keypad so please keep that in mind.
Audio - If your organization enables audio for mobile devices, listen to audio from meetings, training sessions, and webinars with applications in Receiver by enabling the Audio setting. This setting lets you listen only. Receiver for iOS does not offer bi-directional audio.
Setting > Audio
Session Sharing - is the ability for a single user session to host multiple applications. This option is always set to enabled as it usually provides a better user experience.
helpful if you needed to disable session sharing just for a specific iOS user and not all users. (This option is Enabled by default)
Settings > Advanced > Session Sharing
Auto-add favorites - The option creates a shortcut for any application that is launched by the user for easy access the next time they launch their Citrix receiver it will be listed as a favorite for receiver so they do not have to browse to find the application again. (This option is Enabled by Default)
Settings > Advanced > Session Sharing > Auto-add favorites
WorkSpace control - allows users to roam from 1 device to another and have their existing session follow them. While the iOS receiver does not support all of the functions of WorkSpace control it does support the following (These options are Disabled by default)
Settings > Advanced > WorkSpace Control
Which has the following 2 options:
Reconnect during refresh - Will automatically reconnect a user to an existing session if it exists during a refresh on a different device logged in with the same user account.
Caffeine - allows the iOS device not to go into a sleep mode which the Citrix receiver is in use, so for example if the user is idle for 'X' amount of time the iOS device will not shut the screen off. (This option is Disabled by default)
Settings > Advanced > Caffeine
Smartcard Support
This setting is for in-session smartcard recognition. Receiver for iOS 7.x provides support for SITHS smart cards for in-session connections only.
Settings > Advanced > Enable Smart card
Smartcard Support for authentication
NOTE: The option has to be configured during the setup of the account for the iOS device, if not selected you must create the account again to add smartcard support.
Supported VDA Smart Card Middleware:
Supported configurations:
The Citrix X1 mouse - is the only mouse that will allow you to smoothly operate your virtual windows sessions. It supports right click, left click, scrolling , all the typical mouse operations now available in a Citrix session.
Once you have purchased the device and paired it to your iOS device using Bluetooth the next thing you need to do is enable it in Citrix Receiver. (This option is Disabled by default)
Settings > Citrix X1 Mouse
Once enabled start your Citrix session and you will now be able to use the Citrix X1 mouse with your applications even a published desktop.
NOTE: For full details on this product and how to buy 1 refer to the following document.
Citrix X1 Mouse
iOS Receiver Logging - this option is avalible to help Citrix technical support troubleshooting issues with the Citrix iOS receiver when connecting to a XenApp/XenDesktop environment. (this option is Disabled by default)
NOTE: There is an existing article that goes into detail on how to set this up so I will only be showing the location where it can be enabled if needed.
For full details please review
CTX136380 - How to Enable and Collect Advanced Logs for Receiver for iOS
Settings > Support > Log Options
This article is going to go over the more common and new features/options the Citrix receiver for iOS has available along with screenshots, a brief description, and where they are located.
NOTE: This article applies to Citrix iOS versions 5.9 and above.
Features we will be going over are:
- Display Options
- Keyboard Options
- Advanced
First you want to connect your external display in one of the following ways:
- AirPlay
- Lighting to VGA adapter
- Lighting Digital AV Adapter (this has NOT been tested but should work)
Now you are ready to enable the option in Citrix receiver. (This option is Disabled by default)
Settings > Display Options > External Display
Once the option has been enabled you should now be able to see what is on the iOS's devices screen on your external display.
If you wish to then use your iOS device strictly as a keyboard or a touchpad for maneuvering around your external display you simply need to enable Presentation Mode under External display (This option is Disabled by default)
Settings > Display Options > Presentation Mode
NOTE: The Presentation mode option only becomes available when External Display is enabled.
External display is not recommended on anything lower than an iPad-Air or iPhone 5c due to the amount of processing power required by the device.
Auto-Fit Screen - The Auto-fit Screen setting crops the session screen to the display size of iPhone. On iPad, Auto-fit Low/Medium/High will adjust the resolutions as 768x1024/1152x1536/1536x2048 and make applications and desktops fit the screen.
Settings > Display Options > Auto-fit Screen (on iPhone)
Settings > Display Options > Auto-fit Low/Medium/High (on iPad)
Extended Keyboard - is the ability to use all windows key combinations in your Citrix session that the iOS virtual keyboard does not provide for example the key combination Shift + F2 which is commonly used to break out of seamless windows and requires the use of the Windows function keys F1, F2, F3, etc…
Each individual keyboard combination can be enabled or disabled through the extended keyboard option. (Most of these combinations are Disabled by default)
Settings > Keyboard Options > Extended Keys
Use Custom Keyboards - this option is available for users who would like to use a full physical keyboard rather than the virtual keyboard of the iOS device and is typically connected with the devices Bluetooth pairing option. (This option is Disabled by default)
Settings > Keyboard Options > Use Custom Keyboards
NOTE: This feature when enabled since it is an external device as noted by the above pop-up message is less secure than using the iOS devices virtual keypad so please keep that in mind.
Audio - If your organization enables audio for mobile devices, listen to audio from meetings, training sessions, and webinars with applications in Receiver by enabling the Audio setting. This setting lets you listen only. Receiver for iOS does not offer bi-directional audio.
Setting > Audio
Session Sharing - is the ability for a single user session to host multiple applications. This option is always set to enabled as it usually provides a better user experience.
helpful if you needed to disable session sharing just for a specific iOS user and not all users. (This option is Enabled by default)
Settings > Advanced > Session Sharing
Auto-add favorites - The option creates a shortcut for any application that is launched by the user for easy access the next time they launch their Citrix receiver it will be listed as a favorite for receiver so they do not have to browse to find the application again. (This option is Enabled by Default)
Settings > Advanced > Session Sharing > Auto-add favorites
WorkSpace control - allows users to roam from 1 device to another and have their existing session follow them. While the iOS receiver does not support all of the functions of WorkSpace control it does support the following (These options are Disabled by default)
Settings > Advanced > WorkSpace Control
Which has the following 2 options:
- Reconnect during account logon
- Reconnect during refresh
Reconnect during refresh - Will automatically reconnect a user to an existing session if it exists during a refresh on a different device logged in with the same user account.
Caffeine - allows the iOS device not to go into a sleep mode which the Citrix receiver is in use, so for example if the user is idle for 'X' amount of time the iOS device will not shut the screen off. (This option is Disabled by default)
Settings > Advanced > Caffeine
Smartcard Support
This setting is for in-session smartcard recognition. Receiver for iOS 7.x provides support for SITHS smart cards for in-session connections only.
Settings > Advanced > Enable Smart card
Smartcard Support for authentication
Citrix Workspace App For Ios
- allow users to connect to a Citrix environment using their company's smartcard accompanied by a pin number. This feature while available is only supported by the following products and configurations : (This option is Disabled by default )NOTE: The option has to be configured during the setup of the account for the iOS device, if not selected you must create the account again to add smartcard support.
- iOS 7.1 support
- SHA2 certificate support
- Support for single FQDN access implementation
- Precise Biometrics Tactivo for iPad Mini Firmware version 3.8.0
- Precise Biometrics Tactivo for iPad (4th generation) and Tactivo for iPad (3rd generation) and iPad 2 Firmware version 3.8.0
- BaiMobile® 301MP and 301MP-L Smart Card Readers
Supported VDA Smart Card Middleware:
- ActiveIdentity
- PIV cards
- Common Access Card (CAC)
Supported configurations: - Smartcard authentication to NetScaler Gateway with StoreFront 2.x and XenDesktop 5.6 and later or XenApp 6.5 and later.
The Citrix X1 mouse - is the only mouse that will allow you to smoothly operate your virtual windows sessions. It supports right click, left click, scrolling , all the typical mouse operations now available in a Citrix session.
Once you have purchased the device and paired it to your iOS device using Bluetooth the next thing you need to do is enable it in Citrix Receiver. (This option is Disabled by default)
Settings > Citrix X1 Mouse
Once enabled start your Citrix session and you will now be able to use the Citrix X1 mouse with your applications even a published desktop.
NOTE: For full details on this product and how to buy 1 refer to the following document.
Citrix X1 Mouse
iOS Receiver Logging - this option is avalible to help Citrix technical support troubleshooting issues with the Citrix iOS receiver when connecting to a XenApp/XenDesktop environment. (this option is Disabled by default)
NOTE: There is an existing article that goes into detail on how to set this up so I will only be showing the location where it can be enabled if needed.
For full details please review
CTX136380 - How to Enable and Collect Advanced Logs for Receiver for iOS
Settings > Support > Log Options
Citrix Workspace For Ipad Pro