> ## 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.

# Manage Articles

> Admin list view for managing IT knowledge base articles — search, filter, archive, and delete published or draft articles.

The Manage Articles page (`/it/knowledge-base/manage`) is the administrative list view for IT knowledge base articles. It provides search, filtering, archiving, and deletion of articles, and links to the new-article creation flow.

## Overview

The page loads all articles via `useKnowledgeBaseArticles` (combining `filters` state with `searchQuery`). `KBFilterBar` provides additional filter options; `KBSearchBar` handles text search. From the article table, staff can archive an article (calls `archiveArticle.mutate`) or initiate deletion via an `AlertDialog` confirmation (calls `deleteArticle.mutate`).

## Who it's for

No explicit secondary permission gate at the route level beyond the outer `ITViewGuard` (`it.view`). Mutations (archive, delete) require `it.knowledge_base.manage` enforced at the API layer.

## Before you start

* You must hold the appropriate knowledge base management permission (`it.knowledge_base.manage`) to archive or delete articles.
* Read permissions (`it.knowledge_base.view`) are sufficient to view the list.

## Steps

<Steps>
  <Step title="Open the article management list">
    Navigate to `/it/knowledge-base/manage`.
  </Step>

  <Step title="Search and filter articles">
    Use the search bar to search by title or content keywords. Use the filter bar to narrow by category, status, or other available criteria.
  </Step>

  <Step title="Create a new article">
    Click **New Article** to navigate to `/it/knowledge-base/new`.
  </Step>

  <Step title="Archive an article">
    Use the archive action on an article row to disable it without deleting it.
  </Step>

  <Step title="Delete an article">
    Use the delete action on an article row. Confirm the deletion in the dialog. This action cannot be undone.
  </Step>
</Steps>

## Related

<Columns cols={2}>
  <Card title="IT Service Management" icon="headset" href="/it/overview">
    IT Service Management overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</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/it.tsx
  * src/cores/it/pages/knowledge-base/KnowledgeBaseListPage.tsx
  * src/cores/it/hooks/useKnowledgeBaseArticles.ts
  * src/cores/it/hooks/useKnowledgeBaseMutations.ts
</Accordion>