diff --git a/docs/2.guide/2.directory-structure/1.pages.md b/docs/2.guide/2.directory-structure/1.pages.md
index 40ffd8a1ed..688f22891a 100644
--- a/docs/2.guide/2.directory-structure/1.pages.md
+++ b/docs/2.guide/2.directory-structure/1.pages.md
@@ -369,6 +369,10 @@ export default <RouterConfig> {
 }
 ```
 
+::alert
+Nuxt will not augment any new routes you return from the `routes` function with metadata defined in `definePageMeta` of the component you provide. If you want that to happen, you should probably use the `pages:extend` hook which is [called at build-time](/docs/api/advanced/hooks#nuxt-hooks-build-time).
+::
+
 #### Custom History (advanced)
 
 You can optionally override history mode using a function that accepts base url and returns history mode.