diff --git a/docs/src/pages/en/migration/0.21.0.md b/docs/src/pages/en/migration/0.21.0.md
index 971635203..d88e947a6 100644
--- a/docs/src/pages/en/migration/0.21.0.md
+++ b/docs/src/pages/en/migration/0.21.0.md
@@ -62,6 +62,19 @@ const backgroundColor = "rgb(24 121 78)";
 <h-tick>✓</h-tick>
 ```
 
+## Imports on top bug
+
+In Astro v0.21, a bug has been introduced that requires imports inside components to be at the top of your frontmatter.
+
+```astro
+---
+import Component from '../components/component.astro'
+const whereShouldIPutMyImports = "on top!"
+---
+```
+
+*Note: This is a bug that will be fixed.*
+
 ## Components in Markdown
 
 In Astro v0.21, Components from any framework can be used within Markdown files.