---
title: "Adding knowledge base categories block"
slug: "knowledge-base-categories"
description: "With the knowledge base categories block, you can add links that are displayed as cards, and/or popular categories from your documentation.  For example, you want to showcase the popular categories in your knowledge base."
tags: ["Customization", "Body blocks"]
updated: 2026-05-26T11:45:17Z
published: 2026-05-26T11:45:17Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Adding knowledge base categories block

The **Knowledge base categories** block allows you to design a visually appealing and highly functional home page for your Knowledge base site. By showcasing links to popular categories or frequently accessed sections as cards, this feature helps users navigate your documentation effortlessly, improving their overall experience.

Imagine managing a growing Knowledge base for a SaaS product. Customers frequently visit the home page looking for guides, FAQs, or troubleshooting articles. By adding the **Knowledge base categories** block, you can prominently feature "Getting Started," "How-To Guides," or "Troubleshooting Articles" as categories, ensuring users can quickly find the most relevant information. This reduces search time and enhances user satisfaction.

![](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/2_Screenshot-Knowledge_base_site_view_of_Knowledge_base_categories.png)

---

## Adding **Knowledge base categories** block

To add a Knowledge base categories block to your Knowledge base site’s home page, follow the steps below:

1. Navigate to **Settings** (**) in the left navigation bar****in the Knowledge base portal.
2. In the left navigation pane, navigate to **Knowledge base site** > **Site customization**.
3. Click **Customize site** to access the design configurations.

![Site customization options for branding, including theme selection and logo upload.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/Customize-site.png)
4. From the left dropdown, select **Home** page. The **Body** section will display a list of body blocks.
5. Click **Add section** and select **Knowledge base categories**.

![Customize site options with sections like Home, Widgets, and Knowledge base categories.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1771843295247.png)The **Knowledge base categories** block will be added to the list.
6. Click the **Knowledge base categories** to edit the title and overall icon color for the section.
7. Click **Add element** to add more category elements.
8. Select the desired categories from your Knowledge base.
9. Use the **Reorder** (**) icon to rearrange elements.
10. Click the **Hide** (**) icon to toggle the visibility of elements.

The **Reorder** (**) and the **Hide** (**) appears when you hover over any body blocks in the **Body**section.

![Interface showing options to customize the Knowledge Base Categories section in a website.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1771843310610.png)

#### Available options

1. Click a category element to edit the following attributes:

> [!NOTE]
> **** NOTE**
> 
> Use square-dimension image files (e.g., 30 x 30 px, 50 x 50 px) to avoid distortions.
  1. **Icon**:
    - Click **Change** to update icons for each category element.
    - In the **Icons** tab, select either a Document360 or [Font Awesome](https://fontawesome.com/icons) icon.
    - In the **Image** tab, either enter the image URL or upload an image from the Drive.
  1. **Title**: Enter a title for the category element.
  2. **Icon color**: Choose the desired color for the icon.
  3. **Paragraph text**: Add a description for each column using Markdown syntax.
  4. **Text color**: Select the text color for the title and paragraph.
2. Click **Save******to save your changes without applying them immediately.
3. Click **Preview** to see how your changes will appear on the knowledge base site.
4. Click **Publish******to make your recent changes visible to readers.
5. Click the **More** (**) icon and select **Reset to published version** to discard all saved and unsaved customizations and revert to the last published version.

![User interface showing sections for Articles, Categories, and Project Versions in Document360.](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/image-1771843324934.png)

> [!NOTE]
> ** NOTE
> 
> - The **Reset to published version** feature is available only for new Knowledge base site 2.0 projects created after March 29, 2025.
> - The Knowledge base category block only supports categories. When selected, the first article in the category will be displayed by default. Adding individual articles or customizing the block's links is not supported at this time.
> - A category will only appear in the Knowledge base categories block if it contains at least one published article.

---

### FAQ

#### How do I remove**the **Knowledge base categories** block?**

To remove a knowledge base categories block in the Knowledge base site:

1. Navigate to **Settings** (**) in the left navigation bar****in the Knowledge base portal.
2. In the left navigation pane, navigate to **Knowledge base site** > **Site customization**.
3. Click **Customize site** to access the design configurations.
4. From the left dropdown, select **Home** page. The **Body** section will display a list of body blocks.
5. Select the desired **Knowledge base categories** in the **Body** section.
6. Click the **Delete** (**) below the navigation bar.
7. Click **Yes** in the **Delete confirmation** panel.

To delete specific category elements, follow similar steps and select the desired element.

#### Why am I unable to edit the title of the categories/folders under the Knowledge base categories section?

The folders in the Knowledge base categories block are linked directly to the categories in your Documentation section. Because of this, their titles cannot be changed from within the block itself, only the paragraph text field is editable here.

To rename a folder, you need to update the category name in the Documentation section. Follow the steps below:

1. Navigate to **Documentation** (**) in the left navigation bar in the Knowledge base portal.
2. In the **Categories & Articles** pane, locate the category you want to rename.
3. Click the **More** (**) icon next to the category name and select Rename, or double-click the category name to edit it inline.
4. Enter the new name and press **Enter**to save.

#### Is there a limit to the number of category blocks I can add to the homepage design?

No, there is no limit to the number of category blocks you can add to your knowledge base homepage. You can add as many category blocks as needed to suit your homepage layout and content structure.

#### Can I display categories on the homepage only to readers who have access to them?

Yes. If you want specific categories to appear on the homepage only for readers who have permission to access them, it is recommended to use the Knowledge base categories option available in the homepage customization settings.

When categories are added through custom HTML sections or static links, those links are displayed to all readers regardless of their access permissions. As a result, users without permission to view those categories may encounter a 404 page when selecting the link.

Using the built-in Knowledge base categories homepage component ensures that category visibility follows the configured reader permissions. Readers will only see the categories they are authorized to access on the Knowledge base site.