To access the Settings menu, tap the gear icon in the top-right corner on an iPad. On an iPhone, tap Settings on the bottom menu.

Display Options

There are several options to configure your resolution for apps and desktops. Tap Display Options and choose between Auto-fit Low, Auto-fit Medium, and Auto-fit High.


On an iPhone, the options are Small, Medium, and Large. On an iPhone, you can also choose Auto-fit Screen.


On an iPad, you can also enter a custom resolution for your session. The maximum custom resolution is the maximum resolution your iPad supports.

You also can display your session on an external display. This requires specific hardware or devices that support Apple Play. After setting it up, tap External Display to push your session to the external display.

While using your iOS device with an external display, you can use your iOS device as a trackpad to control your session. To do this action, tap Presentation Mode while in External Display mode.


This option is available only while using External Display mode.

Keyboard options

Tap Use Unicode Keyboard to use a standard Unicode keyboard. This option is on by default.

On an iPad, tap Automatic Keyboard to ensure that the keyboard appears onscreen any time within a session when a keyboard is needed. This option is on by default.

Extended Keys lets you use more keys within your session than the default iOS keyboard has. You can choose which keys you want for your keyboard for more functions. On an iPad, choose Extended Keys to view the available keys. On an iPhone, the list of extended keys appears after you choose Keyboard Options. Tap the buttons to choose any extended keys you want to use.

Tap Use Custom Keyboards to use third-party keyboards downloaded from the App Store within your session. The Keyboard Layout Sync automatically synchronizes the keyboard layout of the VDA with that of the client device.


Tap Audio to turn audio from your apps and desktops on or off. This option is on by default.


This setting lets you listen only. Citrix Workspace app for iOS does not offer bi-directional audio.


To launch a StoreFront app using the Safari web browser:

Before iOS 11

  • Tap the icon of the app you want to launch.

    The ICA file downloads automatically, and the app opens automatically in Citrix Workspace app for iOS.

In iOS 11 and iOS 12

  • Tap the icon of the app you want to launch.

    The ICA file downloads automatically, but you must manually open the ICA file by tapping Open in Workspace. The app opens in Citrix Workspace app for iOS thereafter.

    Open in Workspace

In iOS 13


Launching a StoreFront app using the Safari web browser requires the latest version of Citrix Workspace app or Citrix Receiver for iOS (but not both).

  1. Tap the icon of the app you want to launch. You are prompted to download the ICA file.

    Favorites Screen

  2. Tap Download to download the ICA file.

    Download ICA

  3. In the download manager, tap the ICA file. The app launches in Citrix Workspace app for iOS.

    Download Manager

Advanced Settings

Tap Strict Certificate Validation to use the stricter validation policy for server certificates. This option might affect session launches.

TLS Versions allows you to change your TLS settings for troubleshooting purposes. By default, the TLS versions is set to TLS 1.0, 1.1, 1.2.

Tap Use iPad Storage or Use iPhone Storage to use the internal storage of your device. You can use the internal storage rather than saving documents to a cloud service or to your organization’s network server.

Tap Ask Before Exiting to ensure that Citrix Workspace app for iOS confirms with you before disconnecting any session.

On an iPad, tap Session Sharing to move your session from one device to another using Citrix Workspace app for iOS. Even after you share the session you can continue to work in your open apps or desktops. This option is on by default if your organization supports it. Tap Auto-add favorites to automatically add launched apps to your Favorites. This option is on by default.


If session sharing is disabled or not an option (such as on the iPhone), when you tap Home, you disconnect from the session by default. Your apps continue to run on the server. You can roam to another device, log on to the same account, and resume using your apps and desktops.

Tap Use Native Combo Box to use the iOS-native selection feature. This option is on by default.

On an iPad, tap Touch Enable to allow touch for all apps and desktops, including ones that do not have touch options enabled natively, such as Windows 7.

On an iPad, tap Fullscreen Window to view your apps and desktops fullscreen on your iPad device. This option is on by default.

Workspace Control lets you automatically reconnect to a session launched from another device when you add an account or refresh the apps or desktops on the second device, if there is only one session available. Tap Reconnect during account login and/or Reconnect during refresh to enable these options.

Tap Enable HTTP Proxy to use an HTTP proxy for your session. This option has to be configured in your device settings.

Tap Enable Smart card to use a smart card within a session. This option is only to let you use a smart card within a session, not to authenticate to the session.

Tap Session Reliability to ensure that your session stays connected, even if your network connection becomes poor or is interrupted. This option is on by default.

Tap Adaptive Transport Settings to switch EDT on or off. EDT delivers a superior user experience on long-haul WAN and internet connections. Tap Allow EDT to use adaptive transport. This option is on by default. Tap Read EDT stack parameters to troubleshoot EDT problems.

Tap Auto Tablet Mode to ensure that you launch in Tablet Mode on a Windows 10 virtual desktop when there is no keyboard or mouse attached. When a keyboard or a mouse or both are connected to the session, the virtual desktop starts in Desktop Mode. Detaching or attaching hardware toggles between Tablet Mode and Desktop Mode.

Wireless Trackpad lets you use a secondary iOS device as a remote trackpad to control apps or desktops on your primary iOS device. Both devices must have Citrix Workspace app for iOS installed. Pairing controls only Citrix Workspace app for iOS applications on your primary iOS device.

To enable Wireless Trackpad:

  1. Ensure that Bluetooth or Wi-Fi is enabled on both iOS devices.
  2. On the primary iOS device, launch Citrix Workspace app for iOS and then launch the application you want to use.
  3. From the toolbar, tap Pair.
  4. On the secondary iOS device, launch Citrix Workspace app for iOS, then tap Settings
  5. Tap Advanced.
  6. Tap Wireless Trackpad and confirm the connection.

This pairing remains in place until you close the application on the primary iOS device.

The Caffeine function allows your iOS device to stay awake, even while not in active use. Tap Caffeine, then tap Stay Awake to keep your device awake. By default, this option is turned off to conserve battery life.

Citrix X1 Mouse

You can select options for the Citrix X1 Mouse hardware. Contact your Citrix representative for more information about the Citrix X1 Mouse.

Tap Citrix X1 Mouse to switch access to your Citrix X1 Mouse on or off.


The Citrix X1 Mouse and your iOS device must already be paired. For instructions on how to pair the two, see Pairing Citrix X1 Mouse.

Tap Left handed mouse to configure your Citrix X1 Mouse for a left-handed user, switching the mouse click buttons.

Tap Use Remote Cursor Image to make your cursor match the app or desktop within a session. For example, if the cursor is over a text box, it changes to match the text box. This option is on by default.

You can also control the speed of the mouse cursor throughout your session. Move the Speed slider to your desired speed. You can choose any speed between 1.00 (the default speed) and 3.00.

Pairing Citrix X1 Mouse

To pair the Citrix X1 Mouse with your device:

  1. Install the latest version of Citrix Workspace app.
  2. On your device, go to Setting->Bluetooth and enable the Bluetooth option.
  3. Switch on the Citrix X1 Mouse by toggling on the switch that is placed underneath the mouse.
  4. Start the Citrix Workspace app.
  5. Enable the Citrix X1 Mouse option from the Citrix Workspace app Settings menu.
  6. Press the Connect button placed underneath the mouse.
  7. Click Pair when the device prompts you to pair the mouse. Once paired, you can see the mouse cursor.


Mouse clicks work only inside the HDX session.

Troubleshooting Citrix X1 Mouse

If you are unable to see the mouse cursor:

  1. Terminate the Workspace app by swiping up.

  2. On your device, go to Setting->Bluetooth and locate Citrix X1 Mouse.

  3. Press i, and click the Forget This Device option.

  4. Follow the steps 2 through 4 in Pairing X1 Mouse.


  • The Citrix Workspace app with an iPhone can also support external monitors through VGA or HDMI cable.
  • The Citrix X1 Mouse operates as a standard Bluetooth 4.0 Mouse with a PC or Android. (Re-pairing is required).
  • The Citrix X1 Mouse is compatible with only Citrix Workspace app or other supported Citrix apps, not standard iOS apps.
  • Citrix X1 Mouse is compatible with the iPad 3 or later and the iPhone 4s or later.
  • Do not pair the mouse to an iPad or iPhone through iOS settings.
  • For more information, see

Send Usage Statistics

Send Usage Statistics gathers anonymous configuration, events, properties and usage data from Citrix Workspace app. The data is then automatically sent to Citrix to help Citrix improve the quality, reliability, and performance of Workspace app. No user identifiable information is collected from the customer environment.

Note: Disabling this setting does not disable additional logging that your administrator might have enabled.

Security Token

If your organization provides an RSA SecurID Software Token for authentication, install it on your device and authenticate automatically when you launch Citrix Workspace app for iOS. After you install the software token, you can manage the account within the Security Token setting. For more information on the security token, contact your IT administrator.


Tap Report Issue to request help from Citrix Support. Your default email client launches so that you can send information about your issue directly to Citrix Support.

Tap Advanced > Log level to collect error log information and send it to Citrix Support. For more information about log collection, contact your IT administrator.

Tap About to see information about Citrix Workspace app for iOS, including which version you are using and information about third-party notices and user agreements.

Tap Review Citrix Workspace to review Citrix Workspace app for iOS on the App Store.