Customize workspace interactions

Customize how subscribers interact with their workspaces in Workspace Configuration > Customize > Preferences.

If you want to customize workspace preferences that affect the sign-in experience to align with your company requirements, visit Customize workspace security and privacy policies.

If you want to customize the pre-login and post-login workspace appearance, visit Customize the appearance of workspaces

Allow Caching

The Allow Caching setting enhances performance for subscribers accessing Citrix Workspace through a web browser. Caching is supported when accessing Citrix Workspace with a supported web browser. Caching isn’t available when using a locally installed Citrix Workspace app.

When caching is enabled, some sensitive data might be stored locally on subscribers’ devices. This data consists of file metadata and is encrypted with a key that’s unique to the subscriber’s authenticated identity. The encrypted data is stored in the web browser’s localStorage property on the subscriber’s device.

If you disable caching, the encrypted data is purged the next time the subscriber signs in to Citrix Workspace through their web browser. Also, the subscriber can purge this data manually by clearing browsing data from their web browser.

Allow Favorites

Customers, who have access to Workspace Configuration and the new Workspace experience, can allow users to add or remove their favorite apps and desktops on Citrix Workspace app. Users can quickly access their favorite apps and desktop on the Home tab. The Allow Favorites feature is enabled by default.

To configure the Allow Favorites feature, do the following instructions:

  1. Navigate to Workspace Configuration > Customize > Preferences.
  2. Click the toggle button to enable or disable the feature.
  3. Select the declaration checkbox, and click Save.

Citrix Cloud console


For some existing customers (new to Workspace between December 2017 and April 2018), Allow Favorites defaults to Disabled. You can decide when to enable this feature for your users.

User experience

When you enable the Allow Favorites feature, users can add up to 250 favorites by clicking the star icon at the upper-left corner of apps and desktops cards. The star icon turns to a golden color when users mark it as their favorite. Clicking the star icon again removes it from the favorite list.

App cards with star icon states highlighted

When a user adds more than 250 favorite resources, the oldest favorite resource is removed (or as close as possible) to preserve the most recent favorite resources.

When you disable the Allow Favorites feature, the favorites resources get removed from the Home tab of Citrix Workspace app. And, it’s not available for quick access. Users can still access those resources from the Apps tab and Desktops tab.


  • Allow Favorites feature is enabled by default.
  • If your users don’t have access to the desktops configured, the Desktop tab doesn’t appear on the navigation bar.

Apps and Desktops keywords

You can automatically add favorite apps or desktops for users by using KEYWORDS:Auto and KEYWORDS:Mandatory settings in Citrix DaaS (Manage > Full Configuration > Applications).

Application Settings Identification

  • KEYWORDS:Auto - The app or desktop is added as a favorite and users can remove it from the favorite list as per their preference.
  • KEYWORDS:Mandatory - The app or desktop is added as a favorite, and users can’t reverse this action. Mandatory apps and desktops display a star icon with a padlock to indicate that it can’t be removed from the favorite list.

    Favorite Apps with locked star icon


If you use both Mandatory and Auto keywords for an app, the Mandatory keyword overrides the Auto keyword, and the apps or desktops that are added as favorites can’t be removed.

Enable or disable Home screen for users (Preview)

You can enable or disable the Home page for your users to improve the organization of their apps.

This feature is applicable when users have more than 20 apps on their desktop. If the users have 20 apps or less, then they see a single view with no navigation and search options.

To configure the settings, navigate to Workspace configuration > Customize > Appearance. When the toggle is on, users are navigated to the Home page. If you disable the toggle, the users land directly on the Apps page. By default, the toggle is on and the feature is enabled.

Enable home screen

Automatically Launch Desktop

Automatically Launch Desktop is available to customers who have access to Workspace Configuration and the new Workspace experience. The preference only applies to workspace access from a browser.

Preferences tab

When disabled (default), the setting prevents Citrix Workspace from automatically starting a desktop when a subscriber signs in. Subscribers must manually launch their desktop after signing in.

When enabled, if a subscriber has only one available desktop, the desktop automatically launches when the subscriber signs in to their workspace.

The subscriber’s applications aren’t reconnected, regardless of the Workspace control configuration.


To enable Citrix Workspace to launch desktops automatically, subscribers accessing the site through Internet Explorer must add the Workspace URL to the Local intranet or Trusted sites zones.

Federated identity provider sessions

When Workspace is configured to use a federated identity provider, the authentication session and its lifetime are typically controlled by the identity provider. The Federated Identity Provider Sessions setting allows the control to be handed off to the Service Provider. When enabled (default), Workspace forces a sign-in prompt with the identity provider when a new Workspace session is needed. When disabled, a subscriber won’t be prompted to authenticate with the identity provider if accessing Workspace with a valid session.

If this setting is enabled and you’re using Microsoft Entra ID (formerly Microsoft Azure AD) for workspace authentication, subscribers might be prompted to sign in again even if a valid Microsoft authentication token exists for their session. For more information about this scenario, see CTX253779.

Launching apps and desktops

The Launching apps and desktops setting is available to customers who have access to Workspace Configuration and the new Workspace experience. The preference is available to new and existing customers. However, the introduction of this feature doesn’t change any settings for existing customers.

The preference applies to the way users open apps and desktops delivered by Citrix DaaS only. This can be the Citrix DaaS service or on-premises from the Site aggregation feature. Launching apps and desktops doesn’t apply, for example, to SaaS apps delivered by the Citrix Gateway service.

Workspace Preferences settings

Choose one of the following settings:

  • In a native app (default): End users are required to use a locally installed version of the Workspace app.
  • In a browser: End users are required to use a browser version of the Workspace app for HTML5.
  • Let end users choose: End users can choose between a locally installed version of the Workspace app or launch apps and desktops in a browser.

An additional option for In a native app and Let end users choose prompts users to install the latest version of Citrix Workspace app if a local app isn’t detected automatically. Remove this selection if your subscribers don’t have the rights to install software.

Manage installation prompt for Workspace Web Extension

Workspace can detect whether a user has installed Workspace Web Extension on their device or not. If not, Workspace prompts the user to download and install the extension. The Workspace detection step doesn’t get displayed if the user installs the extension.

To manage installation prompt for Workspace Web Extension, navigate to Workspace Configuration > Customize > Preferences > Launching apps and desktops, and then choose one of the following settings:

  • Prompt end users to download the Workspace Web Extension but allow access to Workspace if it isn’t detected (default): End users are allowed to use Workspace even if they decide to install the Workspace Web Extension later.
  • Require end users to download the Workspace Web Extension and block access to Workspace until it is detected: End users aren’t allowed to use Workspace until they install the Workspace Web Extension.
  • Do not prompt end users to download the Workspace Web Extension: Workspace doesn’t prompt end users to install the Workspace Web Extension.

Integrate Microsoft Teams with Workspace

With the Microsoft Teams integration, subscribers can share cards from their Workspace Activity Feed with other subscribers through channels in Microsoft Teams.


  • You must be a Full Access administrator in Citrix Cloud to enable Microsoft Teams integration. Administrators with Custom Access don’t have the required permissions to enable Microsoft Teams integration.
  • You must configure Microsoft Entra ID authentication in Identity and Access Management. For more information about configuring Microsoft Entra ID authentication, see Connect Azure Active Directory to Citrix Cloud.
  • You can use only one Microsoft Entra ID instance with Microsoft Teams. If the Microsoft Entra ID instance you configure has Microsoft Teams enabled through another Citrix Cloud account, you can’t enable Microsoft Teams integration for your Citrix Cloud account.
  • The feature toggle IwsMicrosoftTeams must be enabled.
  • You must have the Actions and Activity Feed feature enabled for workspaces.
  • Workspace subscribers must have the Microsoft Teams desktop client installed.

Enable Microsoft Teams integration

  1. After signing in to Citrix Cloud, select Workspace Configuration.
  2. Select Customize, and then the Preferences tab.
  3. Under Enable Microsoft Teams, select the toggle to enable.

    Enable button in Workspace preference console

  4. Select Save.

    Workspace users can now see the Send to Microsoft Teams option and share cards from Workspace. Users might need to refresh their screens (Ctrl+F5).

    Workspace Activity Feed with Send to Microsoft Teams highlighted

Accept Workspace permissions

There are other set-up steps that are required to enable this integration. The Microsoft Administrator account must accept the permissions of the integration in the Workspace UI so that users of your organization can share cards to Microsoft Teams.

  1. Sign in to any workspace account and try to share a card.
  2. The following message appears if the Microsoft Administrator account hasn’t accepted permissions for integration with Microsoft Teams and you try to sign in with a non-administrator account:

    Need admin approval

  3. To accept permissions, sign in to your administrator account by selecting Have an admin account? Sign in with that account. The following permissions to access data are required to enable the Microsoft Teams integration with Citrix Workspace:

    Permissions requested

  4. When the Permissions accepted dialogue opens, review the options. The Consent on behalf of your organization grants permissions to all Workspace subscribers for this administrator. Otherwise, permissions are granted only for the administrator account.
  5. Select Accept.
Customize workspace interactions