diff --git a/changelog/upgrade-notes.md b/changelog/upgrade-notes.md
index 769ef39c51..03503da390 100644
--- a/changelog/upgrade-notes.md
+++ b/changelog/upgrade-notes.md
@@ -4,6 +4,10 @@
 
 #### Backwards incompatible changes
 
+##### Removal of the "vector" render mode for vector tile layers
+
+If you were previously using `VectorTile` layers with `renderMode: 'vector'`, you have to remove this configuration option. That mode was removed. `'hybrid'` (default) and `'image'` are still available.
+
 ##### New `prerender` and `postrender` layer events replace old `precompose` and `postcompose` events
 
 If you were previously registering for `precompose` and `postcompose` events, you should now register for `prerender` and `postrender` events on layers.  Layers are no longer composed to a single Canvas element.  Instead, they are added to the map viewport as individual elements.