From 12298c5b3b6ce715ac74003d110a37929aea3839 Mon Sep 17 00:00:00 2001
From: 4ian <1280130+4ian@users.noreply.github.com>
Date: Mon, 1 Jun 2026 12:08:23 +0000
Subject: [PATCH] [Auto] [Improve] Keyboard docs: add Key just pressed, Any key
 released, and full key name list

---
 automated_updates_data.json                   |  4 ++
 docs/gdevelop5/all-features/keyboard/index.md | 38 ++++++++++++++-----
 2 files changed, 32 insertions(+), 10 deletions(-)

diff --git a/automated_updates_data.json b/automated_updates_data.json
index b2d10e2b2e..db13e1d506 100644
--- a/automated_updates_data.json
+++ b/automated_updates_data.json
@@ -92,6 +92,10 @@
     {
       "date": "2026-04-22",
       "summary": "Improved resources-loading docs (named Preload scene action, documented SceneLoadingProgress expression and AreSceneAssetsLoaded condition, clarified custom loading screen approach) and added extension lifecycle functions table to events/functions docs"
+    },
+    {
+      "date": "2026-06-01",
+      "summary": "Improved keyboard docs: added 'Key just pressed' and 'Any key released' conditions, full list of valid key names, touchscreen note, and clarified the 'Last pressed key' expression"
     }
   ]
 }
diff --git a/docs/gdevelop5/all-features/keyboard/index.md b/docs/gdevelop5/all-features/keyboard/index.md
index a939ed6bcb..172cf1e57e 100644
--- a/docs/gdevelop5/all-features/keyboard/index.md
+++ b/docs/gdevelop5/all-features/keyboard/index.md
@@ -5,21 +5,31 @@ title: Keyboard
 
 GDevelop gives access to all inputs made on the keyboard. This includes conditions to check if a key was pressed or released.
 
+!!! note
+
+    Keyboard conditions do not work with the on-screen keyboard on touch devices. When making a game for mobile or touchscreen devices, use the **[mouse/touch](/gdevelop5/all-features/mouse-touch)** conditions instead.
+
 ## Any key pressed
 
 For this condition, the corresponding action/s will be performed if any key on the keyboard is pressed.
 
+## Any key released
+
+This condition is true on the frame where any key is released.
+
 ## Key pressed
 
-Whenever the key selected while setting this condition is pressed, the corresponding actions are performed.
+Whenever the key selected while setting this condition is held down, the corresponding actions are performed. This stays true for as long as the key is held.
 
-## Key released
+## Key just pressed
+
+This condition is true only on the frame where the key was first pressed down. Use it instead of "Key pressed" when an action should happen once per key press (for example, jumping or firing a shot) rather than continuously while the key is held.
 
-Whenever the key selected while setting this condition is released, the corresponding actions are performed.
+## Key released
 
-## Key pressed (text expression)
+This condition is true on the frame where the selected key is released.
 
-To test a key press using this condition, you need to enter the key name in the form of text expression. For example, if you want to check condition for left arrow key press, you need to enter "Left" in the field.
+These conditions let you pick the key from a list, but you can also enter the key name as a text expression (for example to use a variable to remap controls). When typing the key name directly, make sure it is surrounded by quotes.
 
 !!! danger
 
@@ -27,15 +37,23 @@ To test a key press using this condition, you need to enter the key name in the
 
 ![](/gdevelop5/all-features/annotation_2019-06-20_191229.png)
 
-## Key released (text expression)
+## Key names
 
-To test a key release using this condition, you need to enter the key name in the form of text expression. For example, if you want to check condition for left arrow key release, you need to enter "Left" in the field.
+When using a key condition with a text expression, or when reading the value returned by the "Last pressed key" expression, the key name must be one of the following:
 
-![](/gdevelop5/all-features/annotation_2019-06-20_191302.png)
+- **Letters:** `a` to `z` (always lowercase, regardless of the Shift key).
+- **Digits (top row):** `Num0` to `Num9`.
+- **Numpad digits:** `Numpad0` to `Numpad9`.
+- **Arrow keys:** `Left`, `Up`, `Right`, `Down` (and the numpad versions `NumpadLeft`, `NumpadUp`, `NumpadRight`, `NumpadDown`).
+- **Modifiers:** `LShift`, `RShift`, `LControl`, `RControl`, `LAlt`, `RAlt`, `LSystem`, `RSystem` (the left/right Windows or Command key), `Menu`.
+- **Function keys:** `F1` to `F12`.
+- **Editing & navigation:** `Space`, `Back` (Backspace), `Tab`, `Return` (Enter), `Escape`, `Delete`, `Insert`, `Home`, `End`, `PageUp`, `PageDown`, `Pause`.
+- **Numpad keys:** `NumpadReturn`, `NumpadHome`, `NumpadEnd`, `NumpadPageUp`, `NumpadPageDown`, `NumpadAdd`, `NumpadSubtract`, `NumpadMultiply`, `NumpadDivide`.
+- **Symbols:** `SemiColon`, `Comma`, `Period`, `Quote`, `Slash`, `BackSlash`, `Equal`, `Dash`, `LBracket`, `RBracket`, `Tilde`, `Add`, `Subtract`, `Multiply`, `Divide`.
 
-## Last key pressed
+## Last pressed key
 
-"Last key pressed" expression returns the last key press in the form of a string. For example, if the last key press is the left arrow key, the expression will return "Left".
+The "Last pressed key" expression returns the name of the most recently pressed key as a string (see the key names above). For example, if the last key pressed is the left arrow key, the expression returns "Left". This is useful to build a "press any key to continue" prompt or to let players remap their controls.
 
 ## Reference