Searching and Browsing
How readers find articles — the three tabs, search behaviour, ranking, category browsing, and the filters on the authoring surface.
On this page
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:
| Tab | What it lists |
|---|---|
| Internal Articles | Articles set to Internal (members only), and articles in a category that is Internal or sits under one. |
| External Articles | Articles set to Portal (customers) with no Internal category above them. |
| Specifications | Articles 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:
- The title is exactly your search — ranked highest.
- The title starts with your search.
- The title contains your search.
- 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.
Symbol-only searches return nothing
A search containing only punctuation has nothing to match on, so it returns an empty result with the message Nothing to search for — "That search only contains symbols. Try words or numbers instead." It deliberately does not fall back to showing everything, which would look like a broken 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.
On the Specifications tab, the Needs attention switch lists only the specs with no linked work, or with unfinished work that has no size or no dates. See Finding specs that need attention.
The Manage table columns#
| Column | Shows |
|---|---|
| Title | The article title |
| State | draft, published, or archived |
| Stage | The article's stage as a coloured badge, or a dash. Shown only once your workspace has stages |
| Progress | How far the spec's linked work has got: a bar, the item count and the percentage done, with a warning chip when the spec needs attention. Shown on the Specifications tab only; see Seeing how far a spec's work has got |
| Visibility | The article's own setting — portal or internal |
| Audience | All companies, N companies, No companies, or Internal |
| Category | Where it is filed |
| Author | Who created it |
| Updated | Relative time, e.g. "3 days ago" |
The Visibility column is not the effective answer
It shows what the article is set to, not what a customer would experience. An article reading
portalhere can still be hidden by an Internal category above it. For the effective answer, check the Internal badge on the category tree or the Live on your customer portal line in the editor.
What each surface includes#
| Team Library | Manage list | Customer Help center | |
|---|---|---|---|
| Drafts | Never | Yours, plus all with permission | Never |
| Published, internal | Yes, badged Internal | Yes | Never |
| Published, portal | Yes | Yes | If category and company allow |
| Archived | Never | Under the Archived filter | Never |
| Company audience applies | No | No | Yes |
| Category audience applies | No | No | Yes |
| Member sharing applies | Yes | Yes | No |
| Stage shown | No | Yes, with a stage filter | Yes, as a badge |
| Split into tabs | Yes | Yes | No |
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.
| Situation | Headline | What it means |
|---|---|---|
| Nothing on this tab yet | No internal articles yet, No external articles yet, or No specifications yet | The tab has no articles to show you. |
| Empty category | No articles in this category yet | Nothing on the current tab is filed in the category. |
| No matches | No results for "widget" | The search ran and found nothing on the current tab. |
| Unsearchable input | Nothing to search for | The search was only symbols. |
| Could not load (Library only) | Articles could not be loaded | A 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:
| Tab | Hint |
|---|---|
| Internal Articles | Articles only your team can read appear here. |
| External Articles | Published articles customers can read appear here. |
| Specifications | Specs 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.