General settings

This section provides information on the following:

  • How to manage the general settings such as how desktops are displayed
  • When to reconnect to different applications and desktops
  • Collect logs

Desktop display

You can display desktops across the entire screen on your user device (full screen mode), which is the default, or in a separate window (windowed mode).

  1. Navigate to the General page of the Preferences dialog box.

    Preferences - general

  2. Select one of the following modes using the Display desktop in option.

    • Full-screen or,
    • Windowed
  3. Click Save and Close.

Desktop Viewer

Your requirements for the way users access virtual desktops can vary from user to user and might vary as your corporate needs evolve.

Use the Desktop Viewer when users interact with their virtual desktop. The user’s virtual desktop can be a published virtual desktop, or a shared or dedicated desktop. In this access scenario, the Desktop Viewer toolbar functionality allows the user to switch a session between windowed and full-screen session window, including multi-monitor support for the intersected monitors.

Users can switch between desktop sessions and use more than one desktop using multiple Citrix Virtual Apps and Desktops or Citrix DaaS connections on the same user device. Buttons to minimize all desktop sessions, send the Ctrl+Alt+Del sequence, disconnect, and Sign out from the session are provided to manage a user’s session conveniently.

Pressing Ctrl+Alt+Break displays the Desktop Viewer toolbar buttons in a pop-up window.

Automatic session reconnects

Citrix Workspace app can reconnect to desktops and applications that are disconnected. For example, a network infrastructure issue.

  1. Navigate to the General page of the Preferences dialog box.

    Preferences - general

  2. Select one of the following options in Reconnect apps and desktops.

    • When I start Workspace app
    • when I start or refresh apps
  3. Click Save and Close.

Collect logs

  1. Navigate to Menu > Preferences. The Citrix Workspace-Preferences dialog appears.

    Preferences dialog

  2. At increasing levels of tracing detail, select one of the following values is available:

    • Disabled
    • Only Error(by default)
    • Normal
    • Verbose
  3. Click Save and Close.

    For more information, see Logging.

DPI matching

The display resolution and DPI scale values set in the Citrix Workspace app match to the corresponding values in the virtual apps and desktops session. You can set the required scale value in the Linux client, and the scaling of the VDA session is updated automatically.

DPI scaling is mostly used with large-size and high-resolution monitors. This feature helps to display the following in a size that can be viewed comfortably:

  • Applications
  • Text
  • Images
  • Other graphical elements


The DPI matching feature supports only GNOME, KDE, and Xfce desktop environments.

This feature is disabled by default. To enable it, do the following:

  1. Go to Menu > Preferences. The Citrix Workspace‑Preferences dialog appears.

    DPI preferences

  2. Navigate to General tab.
  3. Select the Enable and match client DPI scale settings checkbox.
  4. Click OK.


The updated DPI scale settings take effect after you reconnect to Citrix Workspace app.


The DPI matching feature doesn’t support the following:

  • Fractional scaling on the client side.
  • Desktop session that is extended to more than one monitor and when those monitors have different DPIs configured.
General settings