diff --git a/en/appendices/5-3-migration-guide.rst b/en/appendices/5-3-migration-guide.rst
index 9637048fa1..1d532a1336 100644
--- a/en/appendices/5-3-migration-guide.rst
+++ b/en/appendices/5-3-migration-guide.rst
@@ -28,6 +28,13 @@ Database
 - ``Query::with()`` now accepts an array of expressions to align with other query clauses. This also
    allows clearing the expressions with an empty array.
 
+ORM
+---
+
+- ``joinWith()`` now asserts when the association conflicts with an existing join and will overwrite it.
+  Because existing code might harmlessly ignore the join or accidentally rely on that behavior, this change is not breaking
+  in production for CakePHP 5.
+
 Validation
 ----------