diff --git a/basics_user/user-faq.md b/basics_user/user-faq.md
index b217b14c..a7e0ef41 100644
--- a/basics_user/user-faq.md
+++ b/basics_user/user-faq.md
@@ -307,7 +307,17 @@ For details, see the qubes-users mailing list threads [here](https://groups.goog
 
 ### My keyboard layout settings are not behaving correctly. What should I do?
 
-Please read [this discussion](https://groups.google.com/d/topic/qubes-devel/d8ZQ_62asKI/discussion).
+In `Q` → `System Tools` → `Keyboard` → `Layout`, leave the checkbox `Use system defaults` checked. Do not customize the keyboard layout here.
+
+Set the system-wide layout and options for `xorg` with the `localectl` command in `dom0`. You can use `localectl --help` as a starting point.
+
+Example: `localectl set-x11-keymap us dell ,qwerty compose:caps`.
+
+This generates the appropriate configuration in `/etc/X11/xorg.conf.d/00-keyboard.conf`.
+
+Restarting `xorg` is required. The easy way is to reboot the system.
+
+More information in [this discussion](https://groups.google.com/d/topic/qubes-devel/d8ZQ_62asKI/discussion) and [this issue](https://github.com/QubesOS/qubes-issues/issues/1396).
 
 ### My dom0 and/or TemplateVM update stalls when attempting to update via the GUI tool. What should I do?