docs: add note that middleware doesn't run when rendering islands

danielroe · danielroe · commit d22cf7903f3c · 2026-01-21T10:02:35.000Z
diff --git a/docs/2.directory-structure/1.components.md b/docs/2.directory-structure/1.components.md
@@ -535,6 +535,10 @@ This means:
 * You can't access the 'island context' from the rest of your app and you can't access the context of the rest of your app from the island component. In other words, the server component or island is _isolated_ from the rest of your app.
 * Your plugins will run again when rendering the island, unless they have `env: { islands: false }` set (which you can do in an object-syntax plugin).
 
+::important
+Route middleware does not run when rendering island components. Middleware is a routing concept that applies to pages, not components, and is not designed to control component rendering.
+::
+
 Within an island component, you can access its island context through `nuxtApp.ssrContext.islandContext`. Note that while island components are still marked as experimental, the format of this context may change.
 
 ::note
