Knowledge Base

Manage, edit, and reorganize knowledge base articles from the knowledge base panel.

Knowledge Base Preview Mode

The knowledge base panel begins in Preview Mode. With some small exceptions, Preview Mode shows what the published knowledge base will look like.

Note

🤔 Huh? I don’t see “Knowledge Base” in the menu…

This feature is optional; if you don’t see it in the main menu, that means your administrator hasn’t enabled it yet. Administrators can learn more on our admin documentation.

Getting Started

Knowledge Base Link to published knowledge base

Use the ↗️ button in the top toolbar to see the published knowledge base.

Knowledge Base Edit Mode

👆 In Edit Mode, use the righthand menu to navigate through the knowledge base.

Use the “Edit” button in the top toolbar to switch into Edit Mode (and back again).

Note

🤔 Huh? I don’t see an “Edit” button…

By default, agents are not permitted to create, edit, or manage knowledge base articles. If you wish to edit the knowledge base, talk to your administrator about granting you the appropriate permissions.

Switching Languages

Switch languages

Use the language menu to view or edit translations of the current page.

Hint

🚧 What happens when a page hasn’t been translated into the selected language yet?

in Edit Mode

Untranslated pages are marked with a ⚠️ warning sign:

Missing translation warning
in Preview Mode

Untranslated pages are only visible to users with edit permissions:

Missing translation warning
in the published knowledge base

Untranslated pages are always hidden:

Missing translation warning

Using RSS Feeds

Zammad allows you to subscribe to either the knowledge base as whole or to specific categories. There’s both a public and an internal option to do so.

The RSS button of the public knowledge base page is located at the bottom of each page. If enabled, the button will be available to anybody visiting the page.

Screenshot showing the context menu of the RSS button

Note

🤔 Huh? I don’t see an “RSS” button…

By default, RSS feeds are disabled. If you wish to use the RSS function, talk to your administrator about enabling the function.

Editing Categories

Edit category

Hint

📁 If you relocate a category using the Parent menu, all of its articles and sub-categories will be relocated with it.

Note

🗑️ Categories can only be deleted once all of their articles and sub-categories have been deleted or relocated.

Granular Category Permissions

Granular category permissions are great to have individual access levels on a role level. Using the granular permissions of a category deactivates the default visibility behavior and applies the permissions you’ve chosen instead.

This allows you to divide user groups on a e.g. subscription level to reduce the information load for users that don’t need the information.

Screencast showing the visibility option for categories for granular access permissions

Hint

Permissions of a parent category are inherited!
Public answers are always available!

Note

⚙️ Roles require knowledge base reader permission

Your administrator has to provide the relevant groups with reader permissions for the knowledge base.

Danger

🥵 Beware of visibility levels

Knowledge base reader permission means that affected users can see internal answers. This is a potential issue if you’re not dividing carefully!

If you’re unsure, please ask your administrator to configure the role permissions accordingly.

Editing Answers

Edit answer

The knowledge base editor comes equipped with the same rich text editing capabilities available in the Zammad ticket composer. That means you can use the same keyboard shortcuts to insert formatted text, bullet lists, and more. You can even add file attachments and links!

Tip

🤷 Why are there four kinds of links?

🔗 Weblink

URLs pointing to other websites.

💡 Link Answer
Internal references to other knowledge base answers.
(Will not break if destination URL changes.)
📋 Linked Tickets
Internal references to Zammad tickets.
(Visible only in Preview and Edit Modes.)
🏷️ Tags
Tags can help categorize or spice answers with further words to find.
Please note that tags are visible publicly and can be the same like those in your tickets.
Screencast showing tags on answers

Hint

🙈 Set the visibility of an answer to control who can see an article, or schedule it to be published at a later date. Articles are color-coded according to their visibility:

Public (visible to everyone)

Internal (visible to agents & editors only)

Draft/Scheduled/Archived (visible to editors only)

Using answers in ticket articles

As soon as the knowledge base contains one or more answers, you can use these just like text modules. Instead of :: just use ?? to open the search modal. The search is done full text on both answer body and title in all languages available.

If you’ve found what you’ve been looking for, simply hit your ENTER-Key to load the answer into the ticket article. This way you don’t have to throw URLs at your customer and provide the answer right away.

Loading answers into articles does not replace article content.

Screencast showing how to insert KB answers into articles

Use ?? to find and load knowledge base answers into ticket articles