diff --git a/man/waybar.5.scd.in b/man/waybar.5.scd.in
index 624798ed..7223daec 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).
+Note: Tooltip appearance in Waybar is controlled globally via CSS (e.g., `tooltip { ... }`). It is currently not possible to apply tooltip styles per module.
 
 e.g.