Website and folder navigation
Choose the folder names, icons, filters, and views editors see in Studio.
Studio reads .navigation.yml, .navigation.yaml, or .navigation.json. The location matters. For example, the gallery declares its upload root beside package.json, its shared libraries in content/, and the Photos view inside content/photos/.
To change which collection appears first in the sidebar, see Menu order.
| Setting | Where it goes and what it does |
|---|---|
studio.mediaRoot | Website root. Folder that owns uploaded image files. Defaults to public. Use a website-relative directory such as src/assets, or . for the website root. Keep the path inside the website and free of symlinks. |
studio.libraries.images | Content root. Path from content/ to the image library, for example photos. Use the actual folder name, including any numeric prefix. Set this to offer library photos in image pickers. |
studio.libraries.videos | Content root. Path from content/ to the video library, for example videos. Omit either library setting if the website does not offer that picker. |
title | Content folder. Display name in the content browser. Without it Studio derives a label from the folder. |
navigation.icon or icon | Content folder or entry. Icon identifier such as i-lucide-images. Studio checks navigation.icon first. A folder can use its index page’s icon, and entries can inherit a folder icon. Set it to false to use Studio’s default icon. |
studio.view | Content folder. list is the usual browser, single opens a folder’s sole document directly, and media opens the media library. A single view falls back to browsing when the folder has zero or multiple entries. |
studio.story | Content folder. Boolean controlling the Story editor for body-bearing files. Defaults to true. The closest folder declaration wins. Set false for a settings page edited entirely through fields. |
studio.filters | Content folder. List of field paths, or objects with a required field and optional display label. Dot paths select nested values. Studio uses the field type for choices, booleans, or date ranges. The closest declaration wins. Omit for inheritance or use [] to clear inherited filters. |
studio.linkFields | Content folder. List of field paths that get website link suggestions. Use * for one path segment, for example buttons.*.href. Editors can still type a URL. The closest list wins and [] clears it. |
studio.previewUrl | Content folder. Local page to show when an entry has no more specific preview route. The nearest folder with a fallback supplies it. See Preview routes. |
For example, this content/artworks/.navigation.yml gives an editor two ways to narrow a long catalogue.
title: Artworks
icon: i-lucide-palette
studio:
filters:
- field: availability
label: Availability
- artist