Configuration of DPI matching and client-side scaling with Citrix Workspace app for Windows (2024)

CTX230017

Article | Configuration | {{likeCount}} found this helpful | Created: {{articleFormattedCreatedDate}} | Modified: {{articleFormattedModifiedDate}}

Information

DPI scaling is a critical consideration when using high-resolution monitors (over 1920x1080) with Citrix Virtual Apps and Desktops. Without the proper product versions and configuration, the Citrix session could be displayed at resolutions and scales that diverge from the local client configuration, resulting in blurry text and incorrect sizing of graphics.

This article lists the different DPI scaling modes, support requirements, and configuration options available with Citrix Workspace App (CWA) for Windows.

CWA for Windows can be configured in one of three DPI modes:

DPI matching (recommended)

CWA for Windows will match display resolution and DPI scale settings of the local Windows client to the Citrix session. This is the recommended mode for all cases that meet the following system requirements:

Citrix Virtual Apps and Desktops 1912 LTSR* or newer
Multi-session OS VDAs running on Windows Server 2016 or newer
Single-session OS VDAs running on Windows 10 or newer
CWA for Windows 1912 LTSR or newer

Important considerations:

Default mode starting with CWA for Windows 2206.

*1912 LTSR VDAs require that DPI matching be enabled for Virtual Apps (aka seamless or published apps) sessions using the registry key below. Without this key, the VDA will ignore the DPI scale settings of the client for all virtual app sessions, which may result in very small text and graphics.

Client-side scaling (compatibility mode)

CWA for Windows will upscale the Citrix session to match the DPI scale set on the local Windows client. This mode is intended as a temporary solution to support backward compatibility scenarios, where CWA for Windows may be used to connect to legacy XenApp/XenDesktop 7.15 LTSR environments, where DPI matching is not possible but the use of high-resolution monitors and DPI scales above 100% are needed on the client.

Important considerations:

Text and graphics may appear blurry as a result of the upscaling (or stretching) of the Citrix session.
May decrease performance when connecting to sessions using legacy graphics mode.
Local App Access, RTOP, and other plugins that use the window positioning API do not work with Scaling.
Seamless apps will “jump” between monitors to maintain correct scaling, this is by design.

DPI unaware (legacy mode)

CWA for Windows will ignore DPI scale settings on the local Windows client. In this mode, it is up the Windows OS to manage scaling of the CWA and the Citrix session, in the same way it does for any other application that is not DPI-aware. This mode is not recommended for use with DPI scales over 100%.

Important considerations:

Default mode with all versions of CWA for Windows up to 2205.

This mode is not supported with mixed DPI settings, where multiple monitors are connected to the local Windows client and configured with different DPI scales. One monitor with a 100% DPI scale and another monitor with a 150% DPI scale, for example.

Configuration Options

Settings can be configured through CWA for Windows group policy settings, or through the ‘High DPI’ settings under ‘Advanced Preferences’ in CWA for Windows up to version 2205. These settings are also available to configure using the Citrix Global App Configuration Service.

GPO configuration

To configure DPI scaling using theCWA for Windows Group Policy Object administrative template(administrators only)

Under the Computer Configuration node, go to Administrative Templates > Citrix Components > Citrix Workspace > DPI
Select High DPI policy.
Change the settings as required.
- “No, use the native resolution” = DPI matching (recommended)
- “Yes” = Client-side scaling
- “Let the operating system scale the resolution” = DPI unaware
Click Apply and OK.
From a command line, run the gpupdate /force command.

Citrix Workspace app for Windows Advanced Preferences configuration (CWA 2205 and older only)

Note

UI configuration is no longer available starting with CWA 2206.
You can hide all or part of the Advanced Preferences sheet available from the Citrix Workspace app icon in the notification area.
For more information, seeHiding the Advanced Preferencessheet.

To configure DPI scaling using the graphical user interface,

Right-click the CWA for Windows icon in the Windows notification area (systray).
Select ‘Advanced Preferences’ and click ‘High DPI’.
On the page that opens, change the settings as required. By default, the option ‘Let the operating system scale the resolution is selected.
Click Save.
Changes will take effect for subsequent session connections.

Additional Resources

DPI support changes with Citrix Workspace App for Windows 2206
Support for Monitors Including 4K Resolution and Multi-Monitors