diff --git a/kitty/simple_cli_definitions.py b/kitty/simple_cli_definitions.py
index 6fdfbfa0a..cc9ae2721 100644
--- a/kitty/simple_cli_definitions.py
+++ b/kitty/simple_cli_definitions.py
@@ -661,7 +661,9 @@ def build_panel_cli_spec(defaults: dict[str, str]) -> str:
 you to specify which output is used, by name. If not specified the compositor will choose an
 output automatically, typically the last output the user interacted with or the primary monitor.
 Use the special value :code:`list` to get a list of available outputs. Use :code:`listjson` for
-a json encoded output.
+a json encoded output. Note that on Wayland the output can only be set at panel creation time,
+it cannot be changed after creation, nor is there anyway to display a single panel on all outputs.
+Please complain to the Wayland developers about this.
 
 
 --class --app-id