diff --git a/Migration.md b/Migration.md
index 581cbae8..17cc7ae7 100644
--- a/Migration.md
+++ b/Migration.md
@@ -9,6 +9,17 @@ release will remove the deprecated code.
 
 1. The minimum required cmake version is now 3.22.1.
 
+1. **Breaking**: C/C++ projects enable the visibility=hidden by default
+   gz-cmake4 changes the gz-cmake projects to use C/C++ visibility hidden
+   by default. This is a potential breaking changed for projects using
+   gz-cmake but the benefits in terms of creating portable code and
+   time spend by the loader could be relevant.
+   To avoid this change, the EXPOSE_SYMBOLS_BY_DEFAULT flag can be used in
+   the gz_configure_project call.
+   The change deprecates the HIDDEN_SYMBOLS_BY_DEFAULT flag that can be
+   removed.
+
+
 ## Gazebo CMake 2.X to 3.X
 
 1. **Breaking**: Examples are now built using native cmake.