Manage articles and folders

This guide covers every operation available on the /admin landing page — create / rename / move / soft-delete folders, and create / edit / view / delete articles. For the actual content authoring inside an article, use The Editor; this article is purely about the organisation and lifecycle layer.

Open the admin landing

Sign in, open the user menu in the site header (top-right), and click Articles & folders — or visit /admin directly. The page is headed Articles & folders, with Public view and New article buttons at the top-right (users who can manage groups also see Permission rules).

Below the header you'll see:

• A Show row with three filter chips — All, Draft, Published. They filter the article rows only; folders stay visible in every mode so the tree keeps its shape. The chosen filter is kept in the URL (?filter=draft) and survives the actions on this page.

• An Uncategorised block — articles that have no folder. It only appears when there are some.

• A Folder tree section — every folder as a row, followed by its article rows and then its subfolders, indented one level per depth.

Rows are div-row lists, not tables. Each row has an icon on the left, name and slug in the middle (folder rows also show their parent), and a status badge or actions on the right.

Create a folder

• Scroll to the + New folder disclosure at the bottom of the Folder tree section and click it to expand.

• Type the folder name in the Folder name input.

• Optionally pick a parent from the dropdown (leave on — root — for a top-level folder).

• Click Create.

The new folder appears in the tree immediately. Its slug is auto-derived from the name (lower-case, dashes for spaces, alphanumerics only). If a slug collides with an existing folder under the same parent, a -2, -3, … suffix is appended automatically.

Rename a folder

• Click Rename on the folder's row. The name turns into a text input with the existing name pre-filled.

• Edit the name and click Save, or Cancel to discard.

The slug stays the same — folder URLs (/f/) don't change when you rename. This is intentional: bookmarks survive renames.

If you do want a different slug, it can be changed without recreating the folder, but not from this page: the folder admin API accepts a new slug (PATCH /api/kb/admin/folders/ with { "slug": "new-slug" }). The new slug must be unique among the folder's siblings; a clash is refused with a 409. The same call also accepts a sortOrder, which controls where the folder appears in the tree and on the public hub — folders sort by sort order first, then by name.

Move a folder

• Click Move on the folder's row. The name turns into a Move to: dropdown.

• Pick a new parent (or — root — to promote to top-level).

• Click Move, or Cancel to discard.

The dropdown excludes the folder itself and any of its descendants. The system rejects circular references at the API level too, but the UI hides them so you can't accidentally pick one in the first place.

Delete a folder

• Click Delete on the folder's row.

• Confirm the prompt that pops up.

Folder deletes are soft. A red deleted pill replaces the actions on the folder's row, and the folder no longer appears anywhere readers can see (public hub, folder pages, chat-widget).

The row stays in the database with deleted=true for audit purposes. There's no UI button to restore a deleted folder — currently a manual UPDATE kb_folder SET deleted=0 WHERE id=… is the way back.

Create an article

• Click New article at the top of the admin page. The New article form opens at /admin/new.

• Type the Title and optionally pick a folder in Folder (optional) (or leave it as — uncategorised —).

• Click Create draft.

You land in The Editor with an empty body and a DRAFT status — type your content, and use Save Draft to persist progress without publishing.

You can also create an article from the agent API by calling POST /api/kb/admin/articles/import with a markdown body — see the agent docs for the full payload shape.

Edit an article

Click Edit on the article's row to open /admin/edit/ in The Editor. Edits to a published article create a pending draft — the public version stays live until you click Publish, even after several Save Draft cycles. See Article statuses field definitions for the pending-draft chip and the full lifecycle.

View an article

Click View on the row of any PUBLISHED article to open /a/ — the same page readers see — in your browser. Drafts and archived articles don't have a View link because they're not publicly visible.

Delete a draft

Rows with the DRAFT badge have a Delete action in place of View. Click it and confirm the prompt (Permanently delete draft ""? This can't be undone.</strong>). The article, its draft body, and any slug aliases are removed permanently. Only drafts can be deleted this way — published and archived articles are refused, because their links and history must be preserved. For those, use <strong>Archive</strong> in the editor.</p> <h2>Article lifecycle in three buttons</h2> <p>Inside <strong>The Editor</strong>:</p> <ul> <li><p><strong>Save Draft</strong> stores changes without changing visibility.</p> </li> <li><p><strong>Publish</strong> makes the changes visible to all readers (public web + chat-widget). Status becomes PUBLISHED.</p> </li> <li><p><strong>Archive</strong> hides the article from readers without deleting it. Status becomes ARCHIVED and the row stays in the database.</p> </li> </ul> <p>For the full status grid and visibility matrix see <strong>Article statuses field definitions</strong>.</p> <h2>Related</h2> <ul> <li><p><strong>The Knowledge Base</strong> — the three reader surfaces.</p> </li> <li><p><strong>The Editor</strong> — authoring tools.</p> </li> <li><p><strong>Article statuses field definitions</strong> — what each status means.</p> </li> </ul>