diff --git a/docs/userguide b/docs/userguide
index 99fb072c..b684a622 100644
--- a/docs/userguide
+++ b/docs/userguide
@@ -1524,6 +1524,11 @@ i3-msg 'rename workspace to "2: mail"
 bindsym $mod+r exec i3-input -F 'rename workspace to %s' -P 'New name: '
 --------------------------------------------------------------------------
 
+=== Moving workspaces to a different screen
+
+See <<move_to_outputs>> for how to move a container/workspace to a different
+RandR output.
+
 === Moving containers/workspaces to RandR outputs
 
 [[move_to_outputs]]