diff --git a/website/docs/guides/markdown-features/markdown-features-react.mdx b/website/docs/guides/markdown-features/markdown-features-react.mdx
index c5eeb237bc7d..058bc5e15aca 100644
--- a/website/docs/guides/markdown-features/markdown-features-react.mdx
+++ b/website/docs/guides/markdown-features/markdown-features-react.mdx
@@ -198,6 +198,12 @@ I can conveniently use <Highlight color="#25c2a0">Docusaurus green</Highlight> e
 
 :::warning
 
+Registering components to the global scope may not always work. If you're getting errors related to importing a component, make sure to restart/rebuild your application.
+
+:::
+
+:::warning
+
 We use **upper-case** tag names like `Highlight` on purpose.
 
 From MDX v3+ onward (Docusaurus v3+), lower-case tag names are always rendered as native html elements, and will not use any component mapping you provide.