diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2a8a4fe16c..44ba67f93f 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -14,7 +14,9 @@ For a full list of the changes to this release, see the [release notes][0.5.0].
 
 **Breaking changes**:
 
-- ...
+- [Upgrade FontAwesome to v6](https://fontawesome.com/docs/web/setup/upgrade/) from v5. Lots of icons got renamed, but the v5 names will still work.
+
+  Please review the [Backward compatibility](https://fontawesome.com/docs/web/setup/upgrade/whats-changed#backward-compatibility) information for the complete details.
 
 [docsy as an npm package]:
   https://www.docsy.dev/docs/get-started/other-options/#option-3-docsy-as-an-npm-package