diff --git a/doc/migration/3.7/index.rst b/doc/migration/3.7/index.rst
index aaa6c847..d3bf7159 100644
--- a/doc/migration/3.7/index.rst
+++ b/doc/migration/3.7/index.rst
@@ -1,2 +1,7 @@
 Migrating From Version 3.6 to 3.7
 =================================
+
+System Tray
+-----------
+
+.. include:: tray.rst
diff --git a/doc/migration/3.7/tray.rst b/doc/migration/3.7/tray.rst
new file mode 100644
index 00000000..9e75e299
--- /dev/null
+++ b/doc/migration/3.7/tray.rst
@@ -0,0 +1,6 @@
+..
+  File included directly in other pages describing migrating to the new tray module
+
+Polybar version 3.7 introduced the new tray module and deprecated the legacy
+tray implementation which uses ``tray-position`` to position the tray.
+You should switch over to the tray module as soon as possible.
diff --git a/doc/user/modules/tray.rst b/doc/user/modules/tray.rst
index 74e368a2..5ec4e5f3 100644
--- a/doc/user/modules/tray.rst
+++ b/doc/user/modules/tray.rst
@@ -100,6 +100,11 @@ Example
   format-margin = 8px
   tray-spacing = 8px
 
+Migrating From Legacy Tray Implementation
+-----------------------------------------
+
+.. include:: /migration/3.7/tray.rst
+
 References
 ----------