How do I add the Knowledge Categories block to a Hugo site?

Add a "block: knowledge-categories" entry to the sections list in your page's front matter, then fill in the content fields. HugoBlox renders it automatically — copy the example config above as a starting point.

Is the Knowledge Categories block free to use?

Yes. Every HugoBlox block is free and open-source under the MIT license — use it in personal and commercial projects, with no attribution required.

Can I customize the Knowledge Categories block?

Yes. It exposes 15 content options, and inherits the shared block settings for background, spacing, and colors. You can also describe the changes you want to Hugo Chat AI and it will edit the config for you.

Does the Knowledge Categories block work with any Hugo theme?

The block ships in the open-source HugoBlox kit. Add the kit to any Hugo site and the block becomes available in your page sections — there is no theme lock-in.

hugoblox.com/blocks/knowledge-categories

Knowledge baseFree · MITHugo

Knowledge Categories block

A grid of knowledge-base category cards that routes visitors to the right docs fast.

Customize with AI View source

Add it to any Hugo page's sections list — no build step.

v1Version

15Options

MITLicense

Quick start

Add the Knowledge Categories block

Drop this into your page's front matter, under the sections list. Edit the values, and HugoBlox renders the block — no build step.

Add to your page's sections

- block: knowledge-categories
  content:
    title: Browse the knowledge base
    subtitle: Jump into the most active categories.
    categories:
      - category: research
        title: Research
        description: Lab notes, experiment trackers, and preprint workflows.
        icon:
          name: hero/beaker
          bg_color: bg-primary-100 dark:bg-primary-900/50
          text_color: text-primary-600 dark:text-primary-400
      - category: tutorials
        title: Tutorials
        description: Hands-on guides for Hugo Blox.
        count: 18
    view_all:
      text: See all categories
      link: /categories/

Reference

Configuration

Every option the Knowledge Categories block accepts, generated from its schema.

Content options

Properties set under the block's content key.

Property	Type	Default	Description
`title`	`string`	—	Knowledge base heading, under 6 words. E.g. 'Browse the knowledge base'.
`subtitle`	`string`	—	Inviting subtitle, under 8 words.
`categories`required	`object[]`	—	Categories to render; uses real taxonomy counts when available
`categories[].category`	`string`	—	Taxonomy category name used for lookup (defaults to `title` when omitted)
`categories[].title`	`string`	—	Display label for the category card
`categories[].description`	`string`	—	One-line category summary, under 12 words.
`categories[].icon`	`object`	—	—
`categories[].icon.name`	`string`	—	Icon name (e.g., 'hero/book-open')
`categories[].icon.bg_color`	`string`	bg-primary-100 dark:bg-primary-900/50	Background utility classes for the icon wrapper
`categories[].icon.text_color`	`string`	text-primary-600 dark:text-primary-400	Text color classes for the icon
`categories[].count`	`integer`	—	Optional override for item count (otherwise uses taxonomy count)
`categories[].link`	`string`	—	Override the category URL (defaults to taxonomy page)
`view_all`	`object`	—	—
`view_all.text`required	`string`	—	—
`view_all.link`required	`string`	—	—

Compose

Works well with

Blocks that pair naturally with Knowledge Categories on the same page.

Search Hero Trending Questions

Frequently asked

Knowledge Categories block FAQ

Add a "block: knowledge-categories" entry to the sections list in your page's front matter, then fill in the content fields. HugoBlox renders it automatically — copy the example config above as a starting point.

Ready to build with the Knowledge Categories block?

Customize with AI View source