diff --git a/CHANGELOG.md b/CHANGELOG.md
index f9dea8e9..dfe11f7d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,8 +1,10 @@
 # [0.47.0](https://github.com/uploadcare/blocks/compare/v0.46.3...v0.47.0) (2024-07-02)
 
-### Features
+### BEAKING CHANGES
+
+- extract public api to the composition class ([#676](https://github.com/uploadcare/blocks/issues/676)) ([ea29dd2](https://github.com/uploadcare/blocks/commit/ea29dd2ebfc5b5897c7db8f6dbda608604eea86c)).
 
-- extract public api to the composition class ([#676](https://github.com/uploadcare/blocks/issues/676)) ([ea29dd2](https://github.com/uploadcare/blocks/commit/ea29dd2ebfc5b5897c7db8f6dbda608604eea86c))
+See the [migration guide](https://uploadcare.com/docs/file-uploader/migration-to-0.47.0/) for details.
 
 ## [0.46.3](https://github.com/uploadcare/blocks/compare/v0.46.2...v0.46.3) (2024-07-01)