folder metadata

metadata for folders, set in index.md inside the folder. controls how the folder displays its contents.

fields

field description values
default_view how items are displayed list (default), cards, grid
show_file_list show/hide file listing true (default), false
title folder title any string
description folder description any string

default_view

set the default display mode when visiting the folder:

---
default_view: grid
---
  • list - file browser style (default)
  • cards - card layout with image, title, description, dates
  • grid - thumbnail grid (good for photos)

visitors can still switch views with the toggle button. this just sets the default.

subfolders inherit default_view from root if not set.

show_file_list

hide the file listing to show only the index.md content:

---
show_file_list: false
---

useful for landing pages or standalone content where you don't want the folder contents visible.

example: photo gallery

---
title: Photos
default_view: grid
---

my photo collection.

root folder

the root index.md is special - it also accepts site-wide settings like colors and menus. see customization for those options.

content in index.md

any content after the frontmatter appears above the file listing:

---
title: Blog
default_view: list
---

welcome to my blog. here are my latest posts:

the content renders as markdown above the folder contents.

related

Version 8 · Created Jan 1, 2026 · Modified Feb 2, 2026
chatgpt claude