diff --git a/src/components/base/modal/modal.md b/src/components/base/modal/modal.md
index f94ba68ae5bc536fd5ecf8e1a4f55932f0fb1c48..197233e71fb215e09ce45e8523e9ea0d4c25f4da 100644
--- a/src/components/base/modal/modal.md
+++ b/src/components/base/modal/modal.md
@@ -1,3 +1,5 @@
+> Note: For this component to align with the design system specs, all changes made in [`<gl-new-button>`] need to be merged into [`gl-button`]. [#20229](https://gitlab.com/gitlab-org/gitlab/issues/202209) tracks this effort.
+
 # Modal
 
 <!-- STORY -->