Product Documentation

Dynamic keyboard layout synchronization

Previously, the keyboard layouts on the Linux VDA and on the client device had to be the same. For example, when the keyboard layout changed from English to French on the client device but not on the VDA, key mapping issues might occur and persist until the VDA changed to French too.

Starting with this release, Citrix is addressing the issue by automatically synchronizing the keyboard layout of the VDA with that of the client device. Anytime the keyboard layout on the client device changes, the layout on the VDA follows suit.


This feature is supported on Citrix Receiver for Windows and is compatible with both published apps and desktops.


This feature is disabled by default. Use the ctxreg utility to enable or disable this feature. The feature configuration on a given Linux VDA applies to all sessions on that VDA.

The configure key is “HKEY_LOCAL_MACHINE\SYSTEM \CurrentControlSet\Control\Citrix\SyncKeyboardLayout” and the type is DWORD.

To enable this feature, run the command:

/opt/Citrix/VDA/bin/ctxreg update -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\SyncKeyboardLayout" -v "Enabled" -d "0x00000001"

To disable this feature, run the command:

/opt/Citrix/VDA/bin/ctxreg update -k "HKEY_LOCAL_MACHINE\System\CurrentControlSet\Control\Citrix\SyncKeyboardLayout" -v "Enabled" -d "0x00000000"


With this feature enabled, when the keyboard layout changes on the client device during a session, the keyboard layout of the session changes accordingly.

For example, if you change the keyboard layout on a client device to French (FR):

localized image

Then the keyboard layout of the Linux VDA session also changes to “fr.”

In an application session, you can see this automatic change if you have enabled the language bar:

localized image

In a desktop session, you can see this automatic change in the task bar:

localized image

Dynamic keyboard layout synchronization

In this article