diff --git a/include/wlr/types/wlr_output_layer.h b/include/wlr/types/wlr_output_layer.h
index 9f787e2c6..bd10fd129 100644
--- a/include/wlr/types/wlr_output_layer.h
+++ b/include/wlr/types/wlr_output_layer.h
@@ -32,6 +32,10 @@
  * directly are expected to setup layers, call wlr_output_test(), paint the
  * layers that the backend rejected with the renderer, then call
  * wlr_output_commit().
+ *
+ * Callers are responsible for disabling output layers when they need the full
+ * output contents to be composited onto a single buffer, e.g. during screen
+ * capture.
  */
 struct wlr_output_layer {
 	struct wl_list link; // wlr_output.layers