diff --git a/docs/src/content/docs/index.mdx b/docs/src/content/docs/index.mdx
index d1dee8feeea..985a7e61a15 100644
--- a/docs/src/content/docs/index.mdx
+++ b/docs/src/content/docs/index.mdx
@@ -7,6 +7,12 @@ description: Starlight helps you build beautiful, high-performance documentation
 template: splash
 editUrl: false
 lastUpdated: false
+banner:
+  content: |
+    Updating to Astro 5?
+    <a href="https://github.com/withastro/starlight/releases/tag/%40astrojs/starlight%400.30.0">
+      Learn how to upgrade
+    </a>
 hero:
   title: Make your docs shine with Starlight
   tagline: Everything you need to build a stellar documentation website. Fast, accessible, and easy-to-use.