Knowledge Base
On this page
A knowledge base article is a titled document with rich-text content. Each article carries a status, a type, an owner, an author, a service, a version, a last-reviewed date, and a view counter. Categories form a tree of their own, separate from the articles: an article can be filed in several categories or in none.
For the article statuses, types, and publishing actions that the Default Workflow provides, see Knowledge Base Article Workflow. For how portal readers find and read published articles, see Knowledge Base.
In the Web App
Open Knowledge Base from the Service Desk group of the Web App sidebar.
Browse articles
The Knowledge Base page shows the article grid with the category panel beside it and a preview pane. The preview pane shows the article selected in the grid, laid out by the article stylesheet; see The article preview.
Selecting a category in the category panel filters the grid to the articles filed in that category or in any of its subcategories. Two fixed entries sit ahead of the real categories: Uncategorized lists the articles filed in no category, and All Articles applies no filter.
Create an article
- On the article grid, select New.
- Choose an action from the menu and complete its form. For the create actions of the supplied configuration, see Knowledge Base Article Workflow.
For how the New menu loads create actions, see Create a record with New.
In the Default Workflow, an article can also be created from an incident, a problem, a change request, or a work order with the action Create Quick Article; see Incident Workflow, Problem Workflow, Change Request Workflow, and Work Order Workflow.
File an article in categories
The Categories tab of the article form lists the categories the article is filed in, with the columns Full Name and Public. When the article form is opened from an action that creates an article, the tab shows This area is only available after you save the record instead.
To file the article in a category:
- On the Categories tab, select Add. The Select object from list window opens with the category tree.
- Select one category, and select Select. The article is filed in that category, and the tab lists it.
The first category of the tree is highlighted when the window opens, so Select without choosing a row files the article in that first category. With more than one category selected, Select files the article in none.
To remove the article from a category:
- On the Categories tab, select the category's row.
- Select Delete and confirm with Ok.
Only the link between the article and the category is removed; the category stays in the tree. A category cannot be opened from this tab.
Make an article visible in the Self Service Portal
An article is private unless its public flag is set. The Self Service Portal shows an article only when both of these hold:
- Its public flag is set.
- Its status is Live.
The portal's rights check still applies on top of these two conditions. By default, the public flag of an article is cleared.
For the actions that publish an article in the Default Workflow, see Knowledge Base Article Workflow.
The portal's AI Assistant follows the same rule: it answers from an article only while the article is public and at the Live status, and clearing the public flag takes the article out of its answers from the next question. An article reaches the assistant only after the AI knowledge index has taken it in, so an article published since the index was last updated is not used yet; see AI Knowledge Index. The assistant is given the text of the article, not its attachments or its categories. See AI Assistant.
Alloy Navigator defines two article statuses that cannot be deleted: Live and an inactive status. Every other article status, and every article type, comes from the configuration of your database.
Delete an article
To delete an article, select it in the grid, select Actions, and select Delete; see Delete records for the checks and the messages. Deleting an article removes its links to categories.
Manage categories
The category panel beside the grid holds these controls:
- New (a plus icon), whose menu holds New Category and New Subcategory.
- The arrow buttons Move down and Move up, which move the selected category down or up, swapping it with the sibling next to it.
- Open (three dots), whose menu holds Move to top level, Move to category, Mark as Public, Mark as Internal, Delete, and Properties.
Every command needs your permission to edit Knowledge Base articles. Every command except New Category is also unavailable while All Articles or Uncategorized is selected; New Category stays available on those two entries and with nothing selected. In addition:
- An arrow button is unavailable when the sibling it would swap with is All Articles or Uncategorized.
- Move to top level is available only for a category that has a parent.
- Move to category opens the Select object from list window with a category tree for choosing the new parent. A category cannot be moved under one of its own subcategories.
- Only one of Mark as Public and Mark as Internal is available at a time, depending on whether the selected category is public. Either command changes the selected category alone, not its subcategories.
A category must have a name. The forms for a new category and for a category's properties have a description box. By default, a new category is internal.
The Self Service Portal's category tree lists a category only when the category and all its parent categories are public, among other conditions, so marking a category internal also takes its subcategories out of that tree. See Knowledge Base for the rules.
Reference
This section gives the details of knowledge base articles and of the Knowledge Base in the Web App.
What you can see and change
Two permissions decide which articles you see. The public flag plays no part in this check.
| Permission | What it allows |
|---|---|
| The permission to view all articles | See every article, whatever its status. |
| The permission to view live articles | See only articles at the Live status. |
Either permission is subject to your data-segment restriction. A service account passes the check without either permission, and the data-segment restriction does not apply to it.
The category commands depend on your permission to edit Knowledge Base articles; see Manage categories.
The article form
In the default layout of the article form, the General tab holds the article's details (title, ID, status, author, owner, service, data segment, type, tags, the public flag, version, last-reviewed date, view counter, and rating) and its content. The view counter is read-only. The other tabs are Approvals, Activity, Categories, Custom Data, Related Objects, Notes, History, and Attachments; the Categories tab holds the categories the article is filed in (see File an article in categories).
The article preview
In a new 2026.1 database created with the Default Workflow, the article stylesheet is set so that the preview pane shows the following; see Default Workflow Configuration:
- The title as a heading, then the content.
- Applies to:, one item per category the article is filed in, each shown
as its full path with the ancestors joined by
>, sorted. The list is left out when the article has no category. - Attachments:, one link per attachment followed by its description. A file attachment links to a download of the file, and a link attachment to its own address. The list is left out when the article has no attachment.
- Article ID: with the article's ID, then the modified date and the version.
The General tab of the article's read-only page shows the same content.
Imports, search, ratings, and the view counter
Articles imported through the Import Wizard are all filed in one category
named Import; the wizard creates that category when none exists. See
Import Data for the Import
Wizard. To create articles from Microsoft Word (.docx) files, use the
Knowledge Base Import Tool, a separate utility that is not installed with
Alloy Navigator; see
Import Knowledge Base Articles from Microsoft Word.
The full-text index of articles covers the title, the text of the content, and the notes.
Readers' ratings are kept one per person per article, each with a comment and a date, and are summarized as a number of votes and an average rating. The view counter counts reads of the article in the Self Service Portal and is kept per article, not per person.
Related topics
- Knowledge Base Article Workflow
- Knowledge Base (Self Service Portal)
- Import Knowledge Base Articles from Microsoft Word
- Default Workflow Configuration
- Approvals
- AI Assistant (Self Service Portal)