> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encoreos.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Portal

> Screen at /lo/knowledge providing a searchable organizational knowledge base with featured articles, recent articles, and a category tree.

The Knowledge Portal screen is accessible at `/lo/knowledge` and serves as the central hub for the organization's knowledge base, with search, featured articles, recent articles, and a category browser.

## Overview

The `KnowledgePortalPage` loads featured articles via `useFeaturedArticles(orgId)`, recent articles via `useRecentArticles(orgId)`, and the category tree via `useCategoryTree(orgId)`. The page header shows "Knowledge Portal" with a search bar (`KnowledgeSearchBar`) and two action buttons: "Manage Categories" (navigates to `/lo/knowledge/categories`) and "New Article" (navigates to `/lo/knowledge/articles/new`). The main content area shows featured articles and recent articles as `KnowledgeArticleCard` grids. The `CategoryTree` renders the category hierarchy in a sidebar. Selecting a category filters the displayed articles (via `selectedCategory` state). Selecting an article card navigates to `/lo/knowledge/articles/:articleId`.

## Who it's for

Requires `LO_PERMISSIONS.DASHBOARD_VIEW` (`lo.dashboard.view`) via the shared `LOViewGuard`. Creating articles uses `lo.knowledge.create`.

## Before you start

* `lo.dashboard.view` permission required.
* An active organization context is required.

## Steps

<Steps>
  <Step title="Navigate to Knowledge Portal">Go to `/lo/knowledge`.</Step>
  <Step title="Search for articles">Type in the `KnowledgeSearchBar` to find articles by keyword.</Step>
  <Step title="Browse by category">Select a category in the `CategoryTree` sidebar to filter articles.</Step>
  <Step title="View an article">Select a `KnowledgeArticleCard` to open the article at `/lo/knowledge/articles/:articleId`.</Step>
  <Step title="Create an article">Select "New Article" to navigate to `/lo/knowledge/articles/new`.</Step>
  <Step title="Manage categories">Select "Manage Categories" to navigate to `/lo/knowledge/categories`.</Step>
</Steps>

## Key concepts

* **CategoryTree**: hierarchical category browser component.
* **Featured articles**: a curated subset loaded by `useFeaturedArticles`.
* **Recent articles**: recently accessed or created articles loaded by `useRecentArticles`.

## Related

<Columns cols={2}>
  <Card title="Leadership" icon="compass" href="/lo/overview">
    Leadership core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index">
    Documentation coverage and governance.
  </Card>
</Columns>

<Note>
  This page documents shipped product behavior. It is not medical, legal, or
  billing advice. Verify against your organization's policies and applicable
  regulations before using it for clinical, compliance, or billing decisions.
  Protected health information (PHI) shown in the product is governed by your
  tenant's access controls and is never exposed in this documentation.
</Note>

<Accordion title="Documentation sources">
  * src/routes/lo.tsx
  * src/cores/lo/pages/KnowledgePortalPage.tsx
  * src/cores/lo/hooks/useKnowledgeArticles.ts
  * src/cores/lo/hooks/useKnowledgeCategories.ts
</Accordion>