Skip to content

Change Mapped X Keysym

How do I get to this dialog box?

From X Manager or X Manager for Domains

  1. Click Tools > Keyboard Maps.

  2. Select an editable keyboard map (or click Clone to create a new editable map).

  3. In the Keyboard Maps dialog box, click Map Key.

  4. Select a key in the Explicitly Mapped Keys panel.

  5. In the right panel, click Change Mapped X Keysym. (There are four buttons here; the Unshifted option is often the only one needed.)


    Administrators can also configure Keyboard Maps from the Domain Definitions tab.

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.

Key Keysym
Unshifted 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.
Shifted 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.

More information

Back to top