diff --git a/docs/3.api/1.components/2.nuxt-page.md b/docs/3.api/1.components/2.nuxt-page.md
index 493c5efb1e..09fe79d3de 100644
--- a/docs/3.api/1.components/2.nuxt-page.md
+++ b/docs/3.api/1.components/2.nuxt-page.md
@@ -15,6 +15,10 @@ links:
 It accepts same `name` and `route` props.
 ::
 
+::callout{color="amber" icon="i-ph-warning-duotone"}
+`<NuxtPage>` should be used instead of `<RouterView>` as the former takes additional care on internal states. Otherwise, `useRoute()` may return incorrect paths.
+::
+
 ## Props
 
 - `name`: tells `RouterView` to render the component with the corresponding name in the matched route record's components option.