WWindows

LLinux

AAndroid

mmacOS

iiOS

Modifiers

Modifiers are the special keyboard keys: shift, alt, control & GUI.

Modifiers can be used in two forms within ZMK:

• Modifier Keys → LEFT_SHIFT
• Modifier Functions → LS(code)

Names	Description		W	L	A	m	i
LEFT_SHIFT LSHFT LS(code)	Left Shift ⇧		⭐	⭐	⭐	⭐	⭐
RIGHT_SHIFT RSHFT RS(code)	Right Shift ⇧		⭐	⭐	⭐	⭐	⭐
LEFT_CONTROL LCTRL LC(code)	Left Control		⭐	⭐	⭐	⭐	⭐
RIGHT_CONTROL RCTRL RC(code)	Right Control		⭐	⭐	⭐	⭐	⭐
LEFT_ALT LALT LA(code)	Left Alt		⭐	⭐	⭐	⭐	⭐
RIGHT_ALT RALT RA(code)	Right Alt		⭐	⭐	⭐	⭐	⭐
LEFT_GUI LGUI LG(code) LEFT_WIN LWIN LEFT_COMMAND LCMD LEFT_META LMETA	Left GUI (Windows / Command / Meta)		⭐	⭐	⭐	⭐	⭐
RIGHT_GUI RGUI RG(code) RIGHT_WIN RWIN RIGHT_COMMAND RCMD RIGHT_META RMETA	Right GUI (Windows / Command / Meta)		⭐	⭐	⭐	⭐	⭐

Modifier Keys

These act like any other key code.

• e.g. &kp LEFT_GUI pushes and releases the left GUI key.

Modifier Functions

Modifier functions add one or more modifiers to a code.

These functions take the form: XX(code)

• Modifier functions apply a modifier to a code:
  • &kp LS(A) = LEFT_SHIFT+A (a capitalized A).
• They can be combined:
  • &kp LC(RA(B)) = LEFT_CONTROL+RIGHT_ALT+B
• Some basic codes already include a modifier function in their definition:
  • DOLLAR = LS(NUMBER_4)
• There are left- and right-handed versions of each modifier (also see table above):
  • LS, LC, LA, LG, RS, RC, RA, RG
• Modified keys can safely be rolled-over. Modifier functions are released when another key is pressed.
  • Press &kp LS(A), then press &kp B, release &kp LS(A) and release &kp B results in Ab. Only the A is capitalized.