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 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 and visit /admin directly, or click Admin in the site header. You'll see two sections — FOLDERS and ARTICLES — and a top-right New article button.

The sections are rendered as div-row lists, not tables. Each row has an icon on the left, name + slug in the middle, status badge / actions on the right.

Create a folder

1. Scroll to the + New folder card under FOLDERS and click it to expand.
2. Type the folder name in the Folder name input.
3. Optionally pick a parent from the dropdown (leave on — root — for a top-level folder).
4. Click Create.

The new folder appears in the list 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

1. Click Rename on the folder's row. The name turns into a text input with the existing name pre-filled.
2. Edit the name and click Save, or Cancel to discard.

The slug stays the same — folder URLs (/f/<slug>) don't change when you rename. This is intentional: bookmarks and the chat-widget URL cache survive renames.

If you want the slug to change, you currently need to delete the folder and create a fresh one, then re-categorise its articles via the agent API (or by editing each one).

Move a folder

1. Click Move on the folder's row. The name turns into a Move to: dropdown.
2. Pick a new parent (or — root — to promote to top-level).
3. 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

1. Click Delete on the folder's row.
2. 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 reader, chat-widget). Articles that were inside the folder become uncategorised but stay published.

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

1. Click + New article at the top of the admin page.
2. Pick a folder from the dropdown (or leave it as — uncategorised —) and type the title.
3. 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/<slug> 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/<slug> — the same page readers see — in your browser. Drafts and archived articles don't have a View link because they're not publicly visible.

Article lifecycle in three buttons

Inside The Editor:

• Save Draft stores changes without changing visibility.
• Publish makes the changes visible to all readers (public web + chat-widget). Status becomes PUBLISHED.
• Archive hides the article from readers without deleting it. Status becomes ARCHIVED and the row stays in the database.

For the full status grid and visibility matrix see Article statuses field definitions.

Related

• The Knowledge Base — the three reader surfaces.
• The Editor — authoring tools.
• Article statuses field definitions — what each status means.