diff --git a/docs/2.guide/2.directory-structure/1.pages.md b/docs/2.guide/2.directory-structure/1.pages.md index 283846201d..1367f6f871 100644 --- a/docs/2.guide/2.directory-structure/1.pages.md +++ b/docs/2.guide/2.directory-structure/1.pages.md @@ -226,6 +226,22 @@ definePageMeta({ :link-example{to="/docs/examples/routing/pages"} +## Route Groups + +In some cases, you may want to group a set of routes together in a way which doesn't affect file-based routing. For this purpose, you can put files in a folder which is wrapped in parentheses - `(` and `)`. + +For example: + +```bash [Directory structure] +-| pages/ +---| index.vue +---| (marketing)/ +-----| about.vue +-----| contact.vue +``` + +This will produce `/`, `/about` and `/contact` pages in your app. The `marketing` group is ignored for purposes of your URL structure. + ## Page Metadata You might want to define metadata for each route in your app. You can do this using the `definePageMeta` macro, which will work both in `