diff --git a/doc/config.ini b/doc/config.ini
index b514e00c..df1361c1 100644
--- a/doc/config.ini
+++ b/doc/config.ini
@@ -64,6 +64,14 @@ enable-ipc = true
 
 ; override-redirect = true
 
+; This module is not active by default (to enable it, add it to one of the
+; modules-* list above).
+; Please note that only a single tray can exist at any time. If you launch
+; multiple bars with this module, only a single one will show it, the others
+; will produce a warning. Which bar gets the module is timing dependent and can
+; be quite random.
+; For more information, see the documentation page for this module:
+; https://polybar.readthedocs.io/en/stable/user/modules/tray.html
 [module/systray]
 type = internal/tray
 
diff --git a/doc/user/modules/tray.rst b/doc/user/modules/tray.rst
index 9a6314f7..9f405081 100644
--- a/doc/user/modules/tray.rst
+++ b/doc/user/modules/tray.rst
@@ -15,14 +15,16 @@ the Dropbox application).
 Polybar is only responsible for embedding the windows in the bar and
 positioning them correctly.
 
-.. note::
+.. attention::
 
    Only a single instance of this module can be active at the same time (across
-   all polybar instances).
+   all polybar instances in the same graphical session).
 
    The way the `system tray protocol <systray-spec_>`_ works, at most one tray
    can exist at any time.
    Polybar will produce a warning if additional tray instances are created.
+   This also applies when another tray application (e.g. ``stalonetray``) is
+   active.
 
 For transparent background colors, the tray will use pseudo-transparency, true
 transparency is not possible for the tray icons.