diff --git a/docs/changelog.rst b/docs/changelog.rst
index 38aa4570d..b68e217e4 100644
--- a/docs/changelog.rst
+++ b/docs/changelog.rst
@@ -220,6 +220,8 @@ Detailed list of changes
 
 - Fix :ac:`remote_control_script` not working in a kitty instance run from inside another kitty instance
 
+- quick-access-terminal kitten: Allow configuring the layer on which to display the terminal (:pull:`10242`)
+
 
 
 0.47.4 [2026-06-15]
diff --git a/kittens/quick_access_terminal/main.py b/kittens/quick_access_terminal/main.py
index f4ed4b7fe..ed233ed89 100644
--- a/kittens/quick_access_terminal/main.py
+++ b/kittens/quick_access_terminal/main.py
@@ -40,7 +40,12 @@ opt('columns', '80', long_text=panel_opts['columns'].help)
 
 opt('edge', 'top', choices=panel_opts['edge'].choices, long_text=help_of('edge'))
 
-opt('layer', 'overlay', choices=panel_opts['layer'].choices, long_text=help_of('layer'))
+opt('layer', 'overlay', choices=panel_opts['layer'].choices, long_text='''
+Controls the z-index layer on which the quick access terminal is displayed.
+On Linux, if you want the quick access terminal to inter operate with
+IME systems, you might need to change this to :code:`top`.
+See the documentation of the :option:`kitty +kitten panel --layer` for details.
+''')
 
 opt('background_opacity', '0.85', option_type='unit_float', long_text='''
 The background opacity of the window. This works the same as the kitty