Display options

Display options are optional. Start without them, then add only the overrides your site needs.

Defaults

Homepage defaults:

Writing dates on the homepage are shown by default. Set showDate: false only when you want to hide them.

Descriptions on the homepage are opt-in. showDescription: false and an omitted showDescription both hide descriptions.

Homepage

Use home for the front page preview sections:

home: {
  previewLimit: 3,
  order: ['docs', 'writing'],
  collections: {
    writing: {
      showDate: false,
      showDescription: true,
    },
  },
}

home.order controls section order. Entries are collection keys (for example works, not the display label). Omit home.order to use enabled collections in default order, or set home.preset to lab, blog, docs-writing, or persona for init-style ordering. See Site layout.

home.previewLimit controls how many entries each homepage section shows. Omit it to use 5.

Layout

Use layout: 'list' for compact rows:

home: {
  collections: {
    writing: {
      layout: 'list',
    },
  },
}

Use layout: 'card' for richer rows:

home: {
  collections: {
    docs: {
      layout: 'card',
      showDescription: true,
    },
  },
}

If layout: 'card' is set but showDescription is not true, homepage previews stay compact: title on the left, date on the right for writing entries.

Gap

Spacing presets:

home: {
  collections: {
    docs: {
      gap: 'lg',
    },
  },
}

Collection Indexes

Use collections.<key>.display for collection index pages:

collections: {
  writing: {
    display: {
      layout: 'card',
      gap: 'md',
      showDate: true,
      showDescription: true,
    },
  },
}

Collection index display and homepage display are separate. A writing index can show descriptions while the homepage keeps writing previews compact.

Tags And Icons

Entries can define tags and icons:

---
title: Release notes
date: 2026-05-22
icon: /images/release.svg
tags: [release, notes]
---

Tags are emitted in metadata. They render only when showTags: true.

Icons render on card-style previews when an entry or display config provides an icon.

Search

Pagefind indexes enabled content collections (everything except kind: 'page'). Each searchable region gets a collection:<key> filter attribute.

When two or more collections are searchable, the header search modal shows filter chips (All, writing, projects, and so on). Pick a chip to scope results to that collection.

Standalone pages (kind: 'page') are not included in collection filter chips. Set search: false on an entry to exclude it from the index.