Configure

Feature flag management

Note:

  • Once we’ve applied feature flags, you’ll see the feature flag updates after the next launch of your Citrix Workspace app. When you’re in the Incognito mode also, you’ll see the updates after the next launch.

If an issue occurs with Citrix Workspace app in production, we can disable an affected feature dynamically in Citrix Workspace app even after the feature is shipped. To do so, we use feature flags and a third-party service called LaunchDarkly.

You don’t need to make any configurations to enable traffic to LaunchDarkly, except when you have a firewall or proxy blocking outbound traffic. In that case, you enable traffic to LaunchDarkly through specific URLs or IP addresses, depending on your policy requirements.

To date, for cloud customers, there’s no access to StoreFront to customize Citrix Workspace app for HTML5. In the interim, LaunchDarkly can be used to turn on or off a feature for a specific customer based on their store URLs.

You can enable traffic and communication to LaunchDarkly in the following ways:

Enable traffic to the following URLs

  • events.launchdarkly.com
  • app.launchdarkly.com

List IP addresses in an allow list

If you must list IP addresses in an allow list, for a list of all current IP address ranges, see LaunchDarkly public IP list. You can use this list to verify that your firewall configurations are updated automatically in keeping with the infrastructure updates. For details about the status of the infrastructure changes, see the LaunchDarkly Status page.

Provision to disable LaunchDarkly service

You can disable LaunchDarkly service on both on-premises and cloud stores.

On the cloud setup, administrators can disable the LaunchDarkly service by setting the enableLaunchDarkly attribute to false in the Global App Configuration Service.

For more information, see the Global App Configuration Service documentation.

On the on-premises deployment, to disable the LaunchDarkly service, do the following:

  1. Navigate to the configuration.js file in the HTML5Client folder.
  2. Add the enableLaunchDarkly attribute and set the attribute to false.

    'thirdPartyServices'  : {
    'enableLaunchDarkly' : false
    },
    <!--NeedCopy-->
    
  3. Click Save.

Notes:

  • The option to disable the LaunchDarkly service is applicable for Citrix Workspace app for HTML5 version 2208 and later.
  • By default, the LaunchDarkly service is enabled if the enableLaunchDarkly attribute isn’t present.

Global App Configuration Service

Administrators can customize user settings for sessions that are launched in Citrix Workspace app by using the Global App Configuration Service. Administrators can customize user settings for on-premises and Workspace (Cloud) deployments.

Previously, administrators could only use the configuration.js for this purpose, and it was applicable only for StoreFront users.

Limitation in the feature

  • Global App Config service settings might not work as expected if you’ve installed the AdBlock extension on the browser. [CVADHELP-23003]

Configure

The Global App Configuration Service for Citrix Workspace allows a Citrix administrator to deliver Workspace service URLs and Workspace App settings through a centrally managed service.

For more information, see the Global App Configuration Service documentation.

Notes:

  • This feature is available for workspace and HTTPS‑based stores only.
  • For the Global App Configuration Service to work, verify that your users can access the URL .

Specify the duration of the resize overlay

When the end user resizes the session window, a spinner overlay appears. The onResize events are generated whenever the user resizes a session window. As an administrator, you can specify the duration of the overlay.

Resize overlay

Note:

This feature is applicable for sessions that are launched through the HDX SDK for HTML5.

Configuration

In Citrix Workspace app for HTML5, the configuration.js file is in the C:\Program Files\Citrix\Receiver StoreFront\HTML5Client folder. Edit this file to configure the overlay duration.

Notes:

  • Citrix recommends that you back up the configuration.js file before modifying it.
  • Administrator-level credentials are required to edit the configuration.js file.

To edit the duration:

  1. Navigate to the configuration.js file in the HTML5Client folder.
  2. Locate the resizeOverlayDuration attribute and set the value.

    The default value is 3,500 milliseconds. You can set it in the range of 0 through 3,500.

    For example,

        'ui' : {
            'resizeOverlayDuration': 3500
                }
    <!--NeedCopy-->
    

Clipboard

Before introducing this feature, Citrix Workspace app did not support copying and pasting HTML-formatted text from a local application to another application using the Paste Special feature. As a result, the targeted app (in this case, Microsoft Excel) wouldn’t keep its HTML formatting characteristics.

Citrix Workspace app for HTML5 supports HTML format in addition to plain text between the client and a session. This support is useful for Office apps and browsers. Enhanced clipboard support is available on Chrome and Safari browsers only. You can copy HTML content and keep formatting. When copying a link in Chrome, a <img> tag is added in HTML format, which effectively allows you to copy images and text. This HTML formatting feature is richer than plain text but doesn’t work in all applications.

For more information, see Client clipboard redirection in the Citrix Virtual Apps and Desktops documentation.

Enhanced clipboard experience

You can copy and paste text between the session and the end user’s device. You can do it when you launch multiple Virtual Desktops hosted applications or desktops on Windows, Mac, or Chrome operating systems using the browser based Citrix Workspace app for HTML5.

With this feature, you can use the Ctrl C and Ctrl V hotkeys (for Windows or Chrome operating systems) and CMD C and CMD V hotkeys (for Mac operating system) to copy and paste.

This feature is enabled by default.

On Firefox and Edge browsers, to copy the text from a remote session to a local device, press Ctrl C and then click Confirm.

Disable the copy confirmation dialog by selecting the Disable Copy Confirmation checkbox in Preferences on the toolbar. Clear the checkbox to enable the option again.

To disable the enhanced clipboard experience

To disable this feature, edit the configuration.js file located inside the HTML5Client folder (C:\Program Files\Citrix\Receiver StoreFront\HTML5Client) and set the value of directClipboard to false.

Limitations:

  • You can copy and paste only plain text, images, but not files.
  • doesn’t support large data.
  • The Ctrl key might remain stuck in the down position. This issue occurs when you press the right Ctrl key for a long time and then press C to copy the text. As a workaround, click the right Ctrl key multiple times.
  • Occasionally, copying text requires an extra click through the Copy confirmation dialog when you use Google Chrome, Safari, Edge, and Firefox browsers.
  • Use the Ctrl c or CMD C and Ctrl V or CMD V keys to copy and paste. Occasionally, using the Edit menu or right-click option to copy the text might require an extra click using the Confirm dialog.

Support for copying image clips

Using the standard keyboard shortcuts, you can now copy and paste image clips between your local device and your virtual desktop and app sessions. You can use the standard keyboard shortcuts for copying and pasting while using apps such as:

  • Microsoft Word
  • Microsoft Paint
  • Adobe Photoshop

Previously, this functionality was available only for text for the Google Chrome browser and the Microsoft Edge (Chromium) browser with HTTPS stores. This functionality is now available for text and images. It’s applicable on the Google Chrome browser and the Microsoft Edge (Chromium) browser with HTTPS stores.

  Supported clipboard actions
Google Chrome browser and Microsoft Edge (Chromium) browser with HTTPS stores Image clip copy and paste support. Text copy and paste support
Mozilla Firefox, Internet Explorer, HTTP stores Text copy and paste support

Notes:

  • In general, for security reasons, we recommend you use only HTTPS-based stores.
  • Due to network bandwidth constraints, sessions might become unresponsive when you try to copy and paste an image clip larger than 2 MB.
  • In Microsoft Windows OS and chromeOS devices, use Ctrl + C and Ctrl + V for copy and paste. In Apple Mac devices, use Command + C and Command + V for copy and paste.

  • The right-click functionality works only when you copy and paste from your virtual desktop and app sessions to your local device. It doesn’t work when you copy and paste from the local device to your virtual desktop and app sessions.
  • We’ve tested this feature with BMP, PNG, JPEG, and GIF formats.

Clipboard supports HTML format

Starting with this release, you can use HTML format for clipboard operations between the virtual desktop and the endpoint device. When you copy the HTML data, the source content format is copied, and when you paste the data, the destination content carries the formatting. In addition, HTML format provides a better look and feel.

For more information on how to set the policies, see Client clipboard write allowed formats in the Citrix Virtual Apps and Desktops documentation.

Session sharing

For session sharing to occur, the applications must be hosted on the same machine and must be configured in seamless window mode. Use the same settings for parameters such as window size, color depth, and encryption. Session sharing is enabled by default when a hosted application is made available.

If App Switcher is installed on the machine providing the applications, a taskbar appears at the bottom of the window. The taskbar displays all the applications currently running in the session, enabling users to switch between those applications. Users can configure the taskbar to auto-hide and switch to small icons to minimize the amount of space taken up by the taskbar.

A floating toolbar containing controls for Citrix Workspace app for HTML5 is displayed in the browser tab, as shown in the following figure. The clipboard button enables users to copy and paste plain unicode text between the local clipboard on the device and the resources that run in the browser. Users can use standard Windows shortcuts to copy data. It includes text, tables, and images. You can copy between hosted applications, within the same session and between different sessions. Users can also send the CTRL+ALT+DELETE key combination to their desktops and applications using a button on the toolbar.

Chrome HTML5 toolbar image

When printing a document opened with a hosted application or an application that run on a virtual desktop, the user is given the option to print the document to PDF. The PDF is then transferred to the local device for viewing and printing from a locally attached printer. The file is removed from the device when the user closes the PDF.

A user who clicks a link in a document opened using a hosted application is given the choice of whether to open the URL in a hosted browser application within the session or to use the browser on the local device.

Enhanced app switcher support

When you launch a published application session in full-screen or kiosk mode, the session doesn’t overlap with the desktop taskbar. The app switcher no longer hides the session. This enhancement is supported only in single-monitor mode.

Improved virtual apps and desktops launch experience

Starting with the 2306 release, the improved app and desktop launch experience provide timely and relevant information about the launch status.

Note:

Administrators must upgrade HDX SDK files to use Citrix Workspace app for HTML5 2306 version. The older HDX SDK files are incompatible with the 2306 version and later. To download the latest HDX SDK files, click here. For more information, see the Citrix Workspace app for HTML5 HDX SDK developer docs.

Launch improvements

Configure session launch notification display

Starting with 2307, administrators can enable or disable the display of launch progress notifications using the following configuration. If this configuration is enabled, you see the session launch progress notifications on the lower right of the screen. If this configuration is disabled, you can’t see the session launch progress notifications.

Note:

  • By default, this configuration is enabled.

The following screenshot appears when notifications are enabled.

Launch improvements

The following screenshot appears when notifications are disabled.

Launch improvements

Configuration

You can configure this feature in the following way:

In Citrix Workspace app for HTML5, the configuration.js file is in the C:\Program Files\Citrix\Receiver StoreFront\HTML5Client folder. Edit this file to configure the feature.

Notes:

  • Citrix recommends that you back up the configuration.js file before modifying it.
  • Administrator-level credentials are required to edit the configuration.js file.

To disable the feature, do the following:

  1. Navigate to the configuration.js file in the HTML5Client folder.
  2. Add the CTXTUI attribute and set the attribute to false.

    The following is an example of JSON data:

    {
     "vc_channel": {
     "CTXTUI": false
      }
    }
    <!--NeedCopy-->
    
  3. Save the changes.
Configure