diff --git a/src/gui/kernel/qwindow.cpp b/src/gui/kernel/qwindow.cpp
index f89a3408d34..2568be659ed 100644
--- a/src/gui/kernel/qwindow.cpp
+++ b/src/gui/kernel/qwindow.cpp
@@ -1988,7 +1988,7 @@ void QWindow::setFramePosition(const QPoint &point)
     \endcode
 
     \since 6.9
-    \sa geometry()
+    \sa geometry(), safeAreaMarginsChanged()
 */
 QMargins QWindow::safeAreaMargins() const
 {
@@ -1998,6 +1998,14 @@ QMargins QWindow::safeAreaMargins() const
     return {};
 }
 
+/*!
+    \fn void safeAreaMarginsChanged(QMargins margins)
+
+    This signal is emitted when the safe area margins changed to \a margins.
+
+    \sa safeAreaMargins()
+*/
+
 /*!
     \brief set the position of the window on the desktop to \a pt
 
diff --git a/src/gui/kernel/qwindow.h b/src/gui/kernel/qwindow.h
index dedb2372384..9882c9fff3b 100644
--- a/src/gui/kernel/qwindow.h
+++ b/src/gui/kernel/qwindow.h
@@ -311,7 +311,7 @@ Q_SIGNALS:
     void maximumWidthChanged(int arg);
     void maximumHeightChanged(int arg);
 
-    void safeAreaMarginsChanged(QMargins arg);
+    Q_REVISION(6, 9) void safeAreaMarginsChanged(QMargins arg);
 
     void visibleChanged(bool arg);
     Q_REVISION(2, 1) void visibilityChanged(QWindow::Visibility visibility);