diff --git a/akka-docs/src/main/paradox/project/migration-guide-2.5.x-2.6.x.md b/akka-docs/src/main/paradox/project/migration-guide-2.5.x-2.6.x.md
index 2d1f79d348..a05c9c979c 100644
--- a/akka-docs/src/main/paradox/project/migration-guide-2.5.x-2.6.x.md
+++ b/akka-docs/src/main/paradox/project/migration-guide-2.5.x-2.6.x.md
@@ -9,6 +9,12 @@ This is of course not a drop-in replacement. If there is community interest we
 are open to setting up akka-camel as a separate community-maintained
 repository.
 
+## akka-agent removed
+
+After being deprecated in 2.5.0, the akka-agent module has been removed in 2.6.
+If there is interest it may be moved to a separate, community-maintained
+repository.
+
 ## Scala 2.11 no longer supported
 
 If you are still using Scala 2.11 then you must upgrade to 2.12 or 2.13