diff --git a/CHANGELOG.md b/CHANGELOG.md
index a8113f4..3a76f43 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -3,5 +3,17 @@
 ## [6.0.0](https://github.com/recurly/recurly-client-java/tree/6.0.0) (2026-06-18)
 
 
+# Major Version Release
+
+The 6.x major version of the client pairs with the `v2021-02-25` API version. While there are no breaking changes in the API, the client code does include breaking changes.
+
+## Breaking Changes in the Client
+
+- Replace the global `QueryParams` class with a per-operation class of optional parameters that extends `AbstractQueryParams`
+- Replace `joda-time` dependency and updated other dependencies
+
+## Additional Changes
+
+- Added overloaded methods for any API operations that include optional parameters. It is no longer necessary to instantiate a `QueryParams` (now per-operation params class) if the request is not leveraging any of the optional parameters.