Collections are folders in the file tree. They group pages, drive URL paths, and can have their own layout and sort order. The tree order (manual mode) matches public navigation on docs-style sites.
Each collection has a URL segment (folder slug). Pages inside inherit that path unless they sit at the root.
Root page about.mdx → /about
Page guides/quickstart.mdx → /guides/quickstart
The homepage (index.mdx at root) is always /. Aveiro enforces special paths like /coming-soon for system pages.
Navigation
On documentation and similar templates, the left sidebar builds from the file tree order (manual sort). Reordering pages in the tree changes nav order when that template exposes sidebar navigation.Hide or show site navigation per page in page settings if the layout supports overrides.
Collection settings
Open a collection’s Settings to configure:
Collection name — label in the tree and nav
URL segment — path prefix for child pages
Page layout — which layout template pages inherit
Page order — sort mode override for pages in this folder
Child pages inherit collection layout unless a page sets its own override.
Nesting
You can nest collections for deep docs hierarchies. Keep depth reasonable for navigation — three levels is a practical maximum for most sites.
Collection blocks on pages
MDX Collection components list pages from a folder (or the whole site). On multilingual sites, the block resolves the locale-variant folder for the visitor's language so card titles and summaries match translated pages. They respect the same manual sort order as the file tree — useful for card grids and auto-index pages.
Collection blocks never list the pre-launch coming-soon system page — the same rule prev/next navigation uses.
In the editor, customize each Collection block's size (s, m, l) and weight for card title typography. Default m matches the original card layout.
Root vs folder pages
Root pages sit beside collections at the top level — good for one-off landings (About, Pricing).
Folder pages belong to a collection — good for grouped docs or blog posts.
Tips
Use Manual sort when nav order matters more than alphabetical.
Name collections for URLs early — changing segments breaks external links.
Put shared layout needs at the collection level; override single pages only when needed.
Sent campaigns can auto-create a newsletters collection when you Publish to site from campaign stats — see Campaigns.
