Knowledge base page

Author a knowledge-base layout and article routes using content collections.

The shell does not supply /knowledge-base or its article routes. You can author a support and FAQ section using content collections and your own Astro routes.

Route control

pages.knowledge-base does not create or suppress a route. Registering the collection below loads content, but does not publish article URLs; your own routes must retrieve and render the entries. See Pages for current route controls and limits.

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