Manage settings for hybrid launch
Citrix Workspace app enables its management through Client app management for hybrid launch scenarios.
In a hybrid launch scenario, a user accesses their Citrix resources through a web browser. Upon selecting an app or desktop within the browser interface, the Citrix StoreFront™ server generates an ICA file containing specific instructions for launching that resource. The native Citrix Workspace app reads the ICA file’s contents and initiates the connection to the remote application or desktop.
With support for hybrid launch, Client app management now allows you to provide a consistent experience for your users, regardless of whether they access the store through the native app or a browser.
Hybrid launch supports two modes:
-
Citrix Workspace launcher - Citrix Workspace launcher is a component of Citrix Workspace app that allows a store website to detect Citrix Workspace app and launch virtual apps and desktops without requiring an .ICA file download.
-
Citrix web extension - Citrix web extension establishes a secure and reliable connection between Citrix Workspace™ web client and locally installed Citrix Workspace app. It streamlines the opening of apps and desktops from the web client to the native app, which uses HDX™ protocol. When you access the web client and open any apps or desktops after installing this extension on your browser, the extension opens the app or desktop from your native Citrix Workspace app.
Supported versions of Citrix Workspace app
| Citrix Workspace app platform | Minimum supported version |
|---|---|
| Windows | 2503 |
| macOS | 2503 |
| Storefront | 2503 |
Hybrid Launch with Citrix web extension
| Citrix Workspace app platform | Minimum supported version |
|---|---|
| Windows | 2511.1 |
| macOS | 2511.1 |
| Storefront | 2511. |
Verify the Citrix Workspace app behavior
This section describes Citrix Workspace app behavior in various use cases for hybrid mode.
| Scenario | Behavior |
|---|---|
| A user accesses a store via a web browser and launches a session using client redirection. | The in-session settings apply only from the subsequent launch, while the remaining settings become available for use. |
| A user adds a store in the app and then accesses the same store via a web browser. | Settings are retrieved and applied through the natively added store. |
| A user opens a session from Store 1 and then opens another session from Store 2 via a web browser. | The session launched from the most recently accessed store applies its settings. |
| A user opens a session and Client app management settings are changed during the active session. | Client app management settings are applied during the next session launch. |
Note:
Once a session launch is completed, Client app management settings are fetched after the 6-hour time window. If the settings are needed earlier, the user must go to Reset Workspace and launch the session again.
Cloud store support
Citrix Workspace launcher - To get started, administrators need to enable in-memory hybrid launches. This means that you have to disable ICA file download to manage Citrix Workspace app in the case of a hybrid launch. To disable ICA file downloads for Workspace, see Workspace PowerShell documentation.
Citrix web extension - No additional steps needed.
On-premises support
To get started with this feature, the administrators need to meet the following prerequisites:
- Allow list of Client app management endpoint
- Configure registration tool
- Enable in-memory hybrid launches (In case of Citrix Workspace launcher)
- Check Hybrid Launch supported version for Citrix Workspace app and StoreFront.
Allow list of client app management endpoint
For more information, see Prerequisites.
Configure registration tool
For more information, see the Configure registration tool.
Enable in-memory hybrid launches
To enable in-memory hybrid launches, do the following steps:
-
To allow hybrid launches using Citrix Workspace launcher, select the Prompt end users to download Citrix Workspace app (prior to StoreFront 2503, this setting is available as Allow users to download HDX™ engine (plug-in)) checkbox

-
Under Advanced Settings, select the Enable Citrix Workspace Launcher (prior to StoreFront 2503, this setting is available as Enable protocol handler) checkbox.
