diff --git a/changelog/upgrade-notes.md b/changelog/upgrade-notes.md
index 7b2c9f8dfb..716be8bdb2 100644
--- a/changelog/upgrade-notes.md
+++ b/changelog/upgrade-notes.md
@@ -2,8 +2,14 @@
 
 ### Next version
 
+
 Breaking change: The `OverviewMap` control now cannot be instantiated without a list of layers. 
 
+Breaking change: layers can no longer be shared between several `Map` objects.
+
+Breaking change: the `Graticule` control has been replaced by a layer also called `Graticule`, found in `ol/layer/Graticule`.
+The API remains similar.
+
 ### v5.3.0
 
 #### The `getUid` function returns string