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 subscribers to favorite and unfavorite app and desktop resources. The Allow Favorites feature is enabled by default.

Workspace Home Favorites Enabled


  • For some existing customers (new to Workspace between December 2017 and April 2018), Allow Favorites defaults to Disabled. The administrator can decide when to enable this feature for their subscribers.

The subscriber experience of Allow Favorites

When enabled (default), subscribers can add up to 250 Favorites using the star icon at the top left-hand corner of each (non-mandatory) app and desktop card. The star changes from having no fill to a yellow fill when it’s favorited.

App cards with star icon states highlighted

If a subscriber favorites more than 250 resources, the “oldest favorite” is removed (or as close as possible to preserve the most recent Favorites).

When disabled, workspace subscribers don’t see stars on app and desktop cards, or the All Apps and Favorites submenus for these resources in the navigation bar. App and desktop Favorites aren’t deleted and can be recovered if you re-enable Favorites.


If your subscribers do not have access to desktops configured, the desktop selection in the sidebar does not display.

Workspace Favorites Disabled

App and desktop keywords

Administrators can automatically add Favorite Apps for subscribers 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 subscribers can remove the Favorite.
  • KEYWORDS:Mandatory. The app or desktop is added as a Favorite, and subscribers can’t remove the Favorite. Mandatory apps and desktops display a star icon with a padlock to indicate that it can’t be unfavorited.

    Favorited app with locked star icon


If you use both Mandatory and Auto keywords for an app, the Mandatory keyword overrides the Auto keyword, and the favorited app or desktop can’t be removed.

For a subscriber with access only to apps and desktops that have the Mandatory keyword:

  • The subscriber sees only the Apps page in the left navigation pane in Workspace. The Favorite page doesn’t appear in the left pane because there’s no difference in the apps that appear on the Apps page and the Favorite page.
  • The subscriber doesn’t see the Favorite tab on the home page. Only the Recents tab is shown.

    Workspace home page with no Favorites navigation shown

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’ll see a single view with no navigation and search options.

To configure the settings, go to Workspace configuration > Customize > Appearance. When the toggle is on, users are navigated to the Home page. If you turn off 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 will not be prompted to authenticate with the identity provider if accessing Workspace with a valid session.

If this setting is enabled and you’re using 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.

Opening Apps and Desktops

The Opening 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. Opening 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). Uses a locally installed version of Citrix Workspace app and gives the best experience for the platform the subscriber is on.
  • In a browser. Uses Citrix Workspace app for HTML5. No client software is required.
  • Let users choose. Prompts subscribers to detect a locally installed version of Citrix Workspace app, or to use Citrix Workspace app for HTML5 in their browser.

An additional option for In a native app and Let 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 rights to install software.

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 Azure AD authentication in Identity and Access Management. For more information about configuring Azure AD authentication, see Connect Azure Active Directory to Citrix Cloud.
  • You can use only one Azure AD instance with Microsoft Teams. If the Azure AD 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