Manage your workspace experience

This article describes what subscribers see after signing in and how they can interact with their workspace, including guidance for common issues.

Workspace changes for end-users

Browser support

Access workspaces using Internet Explorer 11, or the latest version of Edge, Chrome, Firefox, or Safari.

Workspace features

Card layout

Apps and desktops in your workspace are represented in a “card” layout. A pop-up window shows more details and actions.

You can search everything in your workspace and open apps directly from the search results. Search requires a minimum of three characters.


Recents displays recently opened apps, desktops, and files. For apps and desktops, depending on screen size, you see up to 30 (of each). For files, you see up to 15.


Select the star icon to add an app to Favorites (max 250). Administrators configure this option, so it might not be available.


Access settings from the drop-down menu. The menu contains the user name. The user name comes from the Active Directory display name. If the display name is left blank (we do not recommend this), the domain and account name display.

Select Account Settings for more options.

Workspace Settings console page

  • Activate Citrix Workspace. Downloads a file that adds this workspace to your local Citrix Workspace app.
  • Change Citrix Workspace. Opens a page that checks for a local Citrix Workspace app. This option is not available in Internet Explorer 11.


    This option is only available with Citrix Virtual Apps and Desktops services. Change Citrix Workspace is not available if, for example, you are only using SaaS apps through the Citrix Gateway service.

  • Download Citrix Workspace. Downloads an installation file to your machine. Run the file to install a local Citrix Workspace app for Windows or Mac.

Changes to your service subscription

If you have changed your service subscription, you may need to refresh the local Workspace app manually. In Citrix Workspace app for Windows:

  1. From the Windows system tray, right-click the Citrix Workspace icon, and select Advanced Preferences > Reset Citrix Workspace.
  2. Open Citrix Workspace app for Windows, then select Accounts > Add, and enter the workspace address, for example,

Citrix Workspace Add Account dialog

As an alternative to step 2, you can use a browser to enter the workspace URL and sign in. Then, activate Citrix Workspace from Settings > Account Settings > Activate Citrix Workspace. Activating Citrix Workspace downloads a file with a .CR extension that adds the workspace to your local Citrix Workspace app.

Errors from authentication changes

Subscribers who are logged on to Citrix Workspace may see errors if an administrator changes the authentication method, for example, from Active Directory to Azure Active Directory. If this happens, log off Citrix Workspace and close the browser or Citrix Workspace app. Wait approximately 5 minutes and log back on. When Citrix Workspace is available again, you can log on using the new authentication method.

Register devices for two-factor authentication

Before subscribers can use two-factor authentication plus token with Workspace, they must register their device. During registration, Workspace presents a QR code for the subscriber to scan with an app that follows the Time-Based One-Time Password standard, such as Citrix SSO. For a smooth registration process, Citrix recommends downloading and installing this app on the device beforehand.

  1. From a computer, open a browser, navigate to the Workspace sign-in page, and select Don’t have a token? Password token link on login page
  2. Enter your user name in domain\username format or your company email address and select Next. Workspace user name prompt Citrix Cloud sends you an email with a verification code. This verification code is temporary and is only used to register your device. Do not use this temporary code to sign in to Workspace with two-factor authentication. Verification email with code
  3. After you receive the email, enter the verification code and your Active Directory account password when prompted. Select Next. Verification code entered
  4. From the authenticator app, scan the QR code or enter the verification code manually. QR code scan prompt
  5. Select Finish and Sign In to complete the registration.

After completing registration, subscribers can return to the Workspace sign in page and enter their Active Directory credentials, along with the token displayed in their authenticator app.

SSO app with token code and Workspace login screen


Obtaining temporary email-based tokens is not a supported method for signing in when two-factor authentication is enabled for Workspace. To sign in with two-factor authentication, subscribers must register a device with an authenticator app installed. Subscribers must not use the temporary email token sent during the registration process. Only verification codes that are generated from an authentication app on an enrolled device are supported tokens for two-factor authentication.

Manage your workspace experience