diff --git a/docs/migration.md b/docs/migration.md
index 361750da46..e99e92b793 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -114,6 +114,10 @@ New to Bootstrap 4 is the Reboot, a new stylesheet that builds on Normalize with
 
 - Explicit classes (`.page-item`, `.page-link`) are now required on the descendants of `.pagination`s
 
+### Badges
+
+- Dropped the badge component. Use the `.label-pill` modifier together with the label component instead.
+
 ### Panels, thumbnails, and wells
 
 Dropped entirely for the new card component.