Knowledge Base

Searching and Browsing

How readers find articles — the three tabs, search behaviour, ranking, category browsing, and the filters on the authoring surface.

The three tabs

The Library and Manage articles both list articles under three tabs. Each tab shows only its own articles, and every article is on exactly one:

TabWhat it lists
Internal ArticlesArticles set to Internal (members only), and articles in a category that is Internal or sits under one.
External ArticlesArticles set to Portal (customers) with no Internal category above them.
SpecificationsArticles in a category that holds specs, or in a subcategory of one, whatever their audience.

Specifications comes first: an article in a category that holds specs is listed there even if it is internal. An uncategorized article is never on Specifications, so its own visibility picks between the other two.

The Library lists published articles only. On Manage articles, each tab also holds its drafts and archived articles, so a draft set to Portal (customers) is listed under External Articles even though customers cannot read it yet.

An article's tab follows its settings, so changing its visibility or filing it in another category can move it to a different tab. Which companies it is shared with makes no difference.

The customer Help center has no tabs. See The customer Help center.

Which tab opens

  • Click Knowledge Base in the left navigation, or follow a link that does not name a tab, and you land on the tab you last used in this browser. The first time, that is Internal Articles.
  • Manage articles on the Library and Browse on Manage articles keep you on the same tab.
  • Changing tab clears the selected category. Coming back from an article does not, so you return to the category you were in.

The category panel

The panel lists only the current tab's categories. Every category is listed on exactly one tab:

  • Specifications when the category, or a category above it, has This category holds specs turned on.
  • External Articles when customers can reach it: its audience and the audience of every category above it is Portal (customers).
  • Internal Articles otherwise.

A category from another tab stays in the panel only when you need it to reach one of this tab's categories beneath it. It is shown dimmed; hover its name to read which tab lists it, for example Listed under External Articles.

The article list still follows each article's own settings. A staff-only article filed in a customer-facing category appears under Internal Articles in All Articles and in search, even though its category is listed under External Articles.

On Manage articles, the number beside a category counts only what is listed right now, so it changes with the tab.

Two ways to find an article

Browsing — pick a category from the tree and read what is in it, in the order you curated. Good when the reader knows roughly where to look.

Searching — type words into the search box. Good when they know what they want but not where it lives.

Both are available on all three surfaces: your team's Library, the Manage authoring list, and the customer Help center.

Browsing by category

Selecting a category shows the articles in it and everything in its subcategories, on the current tab. Selecting a top-level product category gives you the whole product's content, not just the handful of articles filed directly at the top.

All Articles clears the category filter and shows everything on the current tab. Uncategorized shows articles with no category at all.

Browse order is the one you curated by dragging rows on the Manage surface — for your team and your customers alike. See Organizing with categories.

Searching

The search box carries the placeholder Search articles and is clearable. It searches as you type, with a short pause so it fires when you stop rather than on every keystroke.

Search covers titles and body text.

On the Library and Manage articles, a search covers the tab you are on. When nothing matches, the message says so, for example Searching in External Articles only. Switch tabs to search the others.

How results are ranked

Results are ordered by how well they match, strongest first:

  1. The title is exactly your search — ranked highest.
  2. The title starts with your search.
  3. The title contains your search.
  4. Everything else — body-text relevance, with title matches weighted more heavily than body matches.

Ties are broken alphabetically by title.

The practical effect: searching password puts an article titled "Password" first, then "Password reset", then "Reset a forgotten password", then articles that merely mention passwords in the body. Partial words match from the start, so pass finds password.

There is no minimum length. Even a search made up only of very common English words — me, the, we — matches from the start of a word, so me finds meetings.

A common word typed alongside other words is ignored rather than demanded: searching reset your password looks for reset and password, and still finds an article that never uses the word your.

Ranking works identically on all three surfaces, so what your customers experience matches what you see when you test a search.

Filters on the Manage surface

The authoring list adds a state filter your readers never see: All, Draft, Published, Archived.

There is one subtlety worth knowing:

  • Browsing with All selected shows drafts and published articles — the active list. Archived articles are not included.
  • Searching with All selected likewise shows drafts and published articles and excludes archived.

Neither browsing nor searching should resurface content you retired. When you genuinely want to find an archived article, select the Archived chip explicitly.

If a category, or the current tab as a whole, has archived articles but nothing active, the list says No active articles to show and points you at the Archived filter, rather than inviting you to write a first article that already exists.

Drafts are filtered per reader: you always see your own, and holders of Publish knowledge-base articles or Manage all knowledge-base articles see everyone's.

Filtering by stage

Once your workspace has stages, a stage filter reading Any stage appears beside the article count. Choose a stage to list only the articles in it; clear it to see every stage again. It narrows browsing and searching alike, and works together with the tab, the state filter, the category and the search box.

While a stage is chosen, articles cannot be reordered by dragging: Clear the stage filter to reorder articles.

The Manage table columns

ColumnShows
TitleThe article title
Statedraft, published, or archived
StageThe article's stage as a coloured badge, or a dash. Shown only once your workspace has stages
VisibilityThe article's own setting — portal or internal
AudienceAll companies, N companies, No companies, or Internal
CategoryWhere it is filed
AuthorWho created it
UpdatedRelative time, e.g. "3 days ago"

What each surface includes

Team LibraryManage listCustomer Help center
DraftsNeverYours, plus all with permissionNever
Published, internalYes, badged InternalYesNever
Published, portalYesYesIf category and company allow
ArchivedNeverUnder the Archived filterNever
Company audience appliesNoNoYes
Category audience appliesNoNoYes
Member sharing appliesYesYesNo
Stage shownNoYes, with a stage filterYes, as a badge
Split into tabsYesYesNo

Your team's Library ignores the customer-facing gates when it decides what a member can read — members see everything published that is shared with them, which out of the box is everything, one tab at a time. That is the point: your support team can reach an internal runbook under Internal Articles and a customer-facing guide under External Articles. An article shared only with certain people or teams is left out of the Library, search, and the Manage list for everyone else.

Result limits

Lists are capped rather than paginated:

  • Manage list — 200 articles
  • Team Library — 50 articles
  • Customer Help center — 50 articles when browsing; a search shows the top 20 matches

On the Library and Manage articles, each limit applies to the tab you are on. In practice you reach these by browsing All Articles in a large knowledge base. Narrow by category or search rather than scrolling.

When nothing comes back

The Library and Manage articles tell these situations apart, so the message tells you what to do. The customer Help center has its own wording.

SituationHeadlineWhat it means
Nothing on this tab yetNo internal articles yet, No external articles yet, or No specifications yetThe tab has no articles to show you.
Empty categoryNo articles in this category yetNothing on the current tab is filed in the category.
No matchesNo results for "widget"The search ran and found nothing on the current tab.
Unsearchable inputNothing to search forThe search was only symbols.
Could not load (Library only)Articles could not be loadedA network or server problem — use Try again.

The last one is not an empty result. If you see it, the list is unknown rather than empty, and the article count is withheld rather than shown as zero. On Manage articles, a list that could not load shows the ordinary empty message instead, with no article count beside it.

Each tab's empty message on the Library and Manage articles has its own hint:

TabHint
Internal ArticlesArticles only your team can read appear here.
External ArticlesPublished articles customers can read appear here.
SpecificationsSpecs filed in a category that holds specs appear here. If no category holds specs yet: Edit a category and turn on Holds specs to file specifications.

The switch that hint refers to is This category holds specs, in the category dialog.