diff --git a/Virtual-keyboard.md b/Virtual-keyboard.md
new file mode 100644
index 0000000..1eb8958
--- /dev/null
+++ b/Virtual-keyboard.md
@@ -0,0 +1,58 @@
+KOReader has a built-in [virtual keyboard](https://github.com/koreader/koreader/blob/master/frontend/ui/widget/virtualkeyboard.lua).
+
+
+
+## Keyboard language layouts
+Language layouts can be added in the main menu `Settings` - `Device` - `Keyboard layout`.
+
+
+--
+Earth switches between the added language layouts.
+
+
+
+Holding Earth allows to choose the language layout directly.
+
+
+
+## Keyboard layers
+Shift switches to the upper case layer.
+
+
+--
+Sym switches to the symbols / digits layer.
+
+
+
+
+--
+Äéß switches to the upper unicode table layer.
+
+
+
+
+
+## Keyboard holds and swipes
+More characters and actions can be invoked with buttons holds and swipes.
+
+To input an additional character from a [small popup keyboard](https://github.com/koreader/koreader/pull/4884), swipe to it from the initial button or just tap it.
+
+
+
+
+--
+**Special actions** are invoked with the hold of the following buttons:
+
+
+
+Backspace - deletes all characters to the beginning of the line
+
+← - moves the cursor to the beginning of the line
+
+→ - moves the cursor to the end of the line
+
+↓ - hides the keyboard
+
+
+
+Tap the input field to show the keyboard on.
\ No newline at end of file