Knowledge base page

Searchable FAQ and support articles at /knowledge-base — enable via publier.config.yaml.

The knowledge-base standard page provides a searchable support and FAQ section at /knowledge-base. Enable it in publier.config.yaml, then add src/pages/knowledge-base.astro to shape the layout.

Enable / disable

pages:
  knowledge-base: true   # false to suppress /knowledge-base

Adding KB articles

Knowledge base articles work the same as the docs collection — add .mdx files to a content directory and register a collection. A minimal setup:

import { defineCollection } from 'astro:content';
import { contentLoader } from '@publier/shell/loaders';
import { pagesSchema } from '@publier/shell/schemas';

export const collections = {
  'knowledge-base': defineCollection({
    loader: contentLoader({ base: './src/content/knowledge-base' }),
    schema: pagesSchema,
  }),
};

Then add articles:

---
title: How to reset your password
description: Step-by-step guide to resetting your account password.
---

To reset your password, visit the [account settings](/settings/security)...

Adding a layout

Create src/pages/knowledge-base.astro to build the KB landing page — a search-filtered list, category groups, or a simple <ul> of links:

src/pages/knowledge-base.astro   → adds the /knowledge-base route