What this module does
The Upendo Knowledge Base Listing displays published Knowledge Base articles on a public website page. Visitors can search, filter, sort, browse categories, open article links, and share the current view when those options are enabled.
The Listing is a display module. Staff create and manage articles in Upendo Knowledge Base Manager. The Listing does not create or edit article content.
Who can use it
- Visitors can use the public listing options that an editor enabled.
- Users with website Edit permission for the module can open Configure listing and change this module instance.
- Administrators, Site Admins, Upendo Clients, and Superusers do not automatically receive access to the listing settings unless website grants them Edit permission for the module.
Editors can choose the heading and introduction, the categories and tags included, the featured-article rule, article page, template, navigation style, page size, sort order, search and filter controls, visible article details, empty-state messages, and whether an empty listing is hidden.
The theme is a website-wide setting shared by Knowledge Base Listing and Knowledge Base Viewer modules. Changing it can affect other Knowledge Base display modules on the same website.
Public visitor features
Depending on configuration, visitors can:
- Search help articles.
- Filter by category or topic.
- Sort by recommended order, title, or recently updated date.
- Browse a category sidebar or category tiles.
- View cards, a compact list, an FAQ accordion, or articles grouped by category.
- Open the selected article page.
- Copy or share a link to the current search and filter state.
Only published articles inside the configured category, tag, and featured scope appear. A category or tag outside the configured scope cannot widen the results.
Empty and missing-page behavior
The module has separate messages for an empty library and for a search or filter with no matches. Editors can hide the module when the entire scoped library is empty. If no article page is configured, visitors may still see the list, but article links are disabled until an article page is selected.