diff --git a/CHANGELOG.md b/CHANGELOG.md
index 8b05314..929c838 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,19 @@
 
 - Pin to Pagy 9.x.
 
+Breaking changes based on [CHANGELOG.md](https://github.com/ddnexus/pagy/blob/master/CHANGELOG.md#version-900):
+- BREAKING: Rename :max_limit > :limit_max
+- BREAKING: Rename variable, param, accessor, extra and helper "items" to "limit"
+- BREAKING: Transform the vars positional hash argument in keyword arguments (double splat); internal renaming of setup/assign methods
+- Refactor pagy_get_vars in various backend extras
+- BREAKING: Refactor the fragment url
+- BREAKING: Refactor the anchor_string system
+- BREAKING: Drop the support for 8+ deprecations
+
+Possibly breaking overrides:
+
+The internal **Pagy protected methods have been renamed and refactored**. If you use custom Pagy classes, you may need to search into the code.
+
 ### 0.5.0
 
 - Pin to Pagy 5.x.