diff --git a/doc/global/macros.qdocconf b/doc/global/macros.qdocconf
index 05c27ce293f..b2cabeb0396 100644
--- a/doc/global/macros.qdocconf
+++ b/doc/global/macros.qdocconf
@@ -133,3 +133,5 @@ macro.cmakepropertywebassemblyonly = "\\note This property is used only if targe
 
 macro.cmakepropertyiosonly = "\\note This property is used only if targeting iOS."
 macro.cmakevariableiosonly = "\\note This variable is used only if targeting iOS."
+
+macro.qtpolicydeprecatedbehavior = "\\note The \\c{OLD} behavior of a policy is deprecated, and may be removed in the future."
diff --git a/src/corelib/doc/src/cmake/policy/qtp0002.qdoc b/src/corelib/doc/src/cmake/policy/qtp0002.qdoc
index 4416ac132ae..a40344a1675 100644
--- a/src/corelib/doc/src/cmake/policy/qtp0002.qdoc
+++ b/src/corelib/doc/src/cmake/policy/qtp0002.qdoc
@@ -56,8 +56,7 @@ set_target_properties(
 )
 \endcode
 
-\note The \c{OLD} behavior of a policy is deprecated, and may
-be removed in the future.
+\qtpolicydeprecatedbehavior
 
 \sa qt_policy, {Qt CMake policies}
 
diff --git a/src/corelib/doc/src/cmake/qt_policy.qdoc b/src/corelib/doc/src/cmake/qt_policy.qdoc
index 7c44b4d8241..6deb7a729cb 100644
--- a/src/corelib/doc/src/cmake/qt_policy.qdoc
+++ b/src/corelib/doc/src/cmake/qt_policy.qdoc
@@ -58,8 +58,7 @@ You can set \c behavior to one of the following options:
 \li \c{OLD} to explicitly opt-out of it
 \endlist
 
-\note The \c{OLD} behavior of a policy is deprecated, and may
-be removed in the future.
+\qtpolicydeprecatedbehavior
 
 \sa qt_standard_project_setup