diff --git a/man/waybar.5.scd.in b/man/waybar.5.scd.in
index 8b923eef..c407472f 100644
--- a/man/waybar.5.scd.in
+++ b/man/waybar.5.scd.in
@@ -168,6 +168,7 @@ The visual display elements for waybar use a CSS stylesheet, see *waybar-styles(
 # MODULE FORMAT
 
 You can use PangoMarkupFormat (See https://developer.gnome.org/pango/stable/PangoMarkupFormat.html#PangoMarkupFormat).
+Tooltip appearance is generally controlled globally via CSS and cannot be truly scoped per module. Some modules (such as the clock) provide limited workarounds for customization.
 
 e.g.