Documentation Knowledgebase

This area helps us show you how to use our features to grow your business.

Knowledge Base Listing

Upendo Knowledge Base Listing

The Upendo Knowledge Base Listing shows published Knowledge Base articles on a public page with search, filters, sorting, and category navigation; users with website Edit permission configure its scope, layout, and messages.

Updated

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.

What editors can configure

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.