Change Mapped X Keysym

There are four separate Change Mapped X Keysym buttons on the Map Key tab. In general, only one X Keysym (the one in the unshifted position) needs to be defined for any given key. However, a key can have different Keysyms associated with unshifted and shifted states.


The Keysym associated with this key when it is pressed by itself (without the Shift or AltGr keys). When the remaining X Keysyms are set to NoSymbol (the default), many X clients use this unshifted X Keysym regardless of the state of the Shift or AltGr keys. Use the additional mapping options only if you need a different behavior for shifted and unshifted states.


The Keysym that is associated with the combination of the Shift key and this key.

Alt Gr

The Keysym that is associated with the combination of the Alternate Graphic key and this key. The Alternate Graphic key, also called Mode Switch or abbreviated AltGr, can be found to the right of the space key on most non-U.S. keyboards.

Shifted Alt Gr

The Keysym that is associated with the combination of the Shift key, the Alt Gr key,

Select the X Keysym that corresponds to:

The key that you are planning to change is listed here. Confirm that you have selected the correct Key in the Map Key tab before proceeding.

There are two ways that you can specify the X Keysym assignment for this change:

  • Press a key to locate corresponding X Keysym

    The X Keysym corresponding to the key you press is displayed in this field. You can also use a compose sequence to generate a character and display the corresponding X Keysym (if one exists).

  • Select the X Keysym from a list. Apply filters for category or a character string to help you locate the X Keysym.

    • Filter X Keysym list by category

      X Keysym categories limit the items shown in Select X Keysym from list.

    • Only list X Keysyms whose names contain

      Type a string to limit the list to X Keysyms that contain these characters.

    • Select X Keysym from list

      Select from the list of available X Keysyms.

After selecting an X Keysym and clicking OK, the new mapping is displayed in the list of Explicitly mapped keys.