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

# Organize articles and categories in your Knowledge Base

> Make your Knowledge Base easy to browse. Arrange articles and categories, move content to the right section, and manage navigation without accidentally publishing drafts or deleting useful guidance.

Make your Knowledge Base easier to browse by putting related guidance together and arranging it in the order readers need it. Use Weav's Content sidebar to organize sections, categories, and articles without rewriting the articles themselves.

This guide covers drag-and-drop ordering, keyboard controls, moving articles, names, and safe cleanup.

## Understand the content structure

Go to **Knowledge Base → Content**. The sidebar groups your articles into:

| Level | Purpose | Example |
| --- | --- | --- |
| **Section** | A top-level area of your Knowledge Base. Use the section picker above the content tree to change areas. | Help center or Product guides. |
| **Category** | A group of related articles within a section. | Getting started or Account & security. |
| **Article** | An individual guide, explanation, or answer. | Invite your team or Reset your password. |

**Uncategorized** means an article has no category. When your Knowledge Base uses sections, categories and articles that have no section appear under the first section in your section list. There is no separate "Unsectioned" area. These are different states, not extra levels of nested categories.

The Content sidebar includes drafts. A yellow dot marks a draft article; hover over it or focus it to see **This article is a draft**. Public navigation shows eligible published content, so it will not necessarily match the staff sidebar one for one.

<Note>
  **Organization changes save separately from article drafts.** Reordering and moving items apply when you complete the action; there is no extra Save draft step for the sidebar. These changes can affect navigation on a live site, but they do not publish a draft article or take a private Knowledge Base live.
</Note>

## Reorder articles with drag and drop

1. Open the section and category containing the article.
2. Hover over its row to reveal the six-dot **drag handle** on the left.
3. Press and hold the handle, then drag up or down.
4. Watch the **blue insertion line**. It shows whether the article will land before or after the target row.
5. Release to apply the new order.

A copy of the article label follows the pointer while you drag. Use the handle rather than the article title: selecting the title opens the article instead of picking it up.

![A fictional Acme content sidebar during a drag, with the Create your account drag preview and a blue insertion line showing where the article would land.](https://weav-prod-kb-assets.s3.us-east-1.amazonaws.com/019cb3cc-d799-7017-a219-58d0d310083b/articles/01a1784c-0e4b-73f6-8260-9e3cb6cd698c/cd753f80-36a1-4d9a-99a7-7e508eb7ba08.png)

*This illustration shows a drag in progress. It was canceled without saving a new order.*

### Move to another category in the same section

You can drag an article:

- **Over an article in another category** to choose a position before or after it.
- **Over a category heading** to append it to that category.
- **Over a collapsed category heading** and pause briefly to expand it, then choose a position inside it.
- **Into Uncategorized** to remove its category assignment.

The highlighted category or blue insertion line identifies the destination. Moving to a different category preserves the article's content and publication status.

## Reorder categories

1. Hover over a category heading and find its drag handle in the left margin.
2. Drag the category above or below another category in the **same section**.
3. Use the blue line to choose the position, then release.

The category moves as a group; you do not need to move each article separately. Category dragging does not move categories between sections. Use **Manage sections** to change the order of the sections themselves.

### Use the keyboard instead of dragging

1. Press **Tab** until the article or category drag handle has focus. Handles become visible when focused.
2. Press **Space** to pick up the item.
3. Use the **arrow keys** to move it to a new position in the visible list.
4. Press **Space** again to drop and save it, or **Esc** to cancel the drag.

Use the article's **Move to** menu for a destination in another section rather than trying to drag through the section picker.

## Add and rename categories

### Create a category

1. Choose the section where the category belongs.
2. Select **New category** at the bottom of the content tree.
3. Enter a clear name in **Category name**.
4. Select **Save** or press **Enter**.

The category is created in the section you are viewing. A name made only of spaces is not valid; if creation fails, the error appears in the dialog so you can correct it.

Select **Cancel** or press **Esc** to close the dialog without creating anything.

![The New category dialog in a fictional Acme workspace, with Billing & subscriptions entered as an example name and Save and Cancel controls visible.](https://weav-prod-kb-assets.s3.us-east-1.amazonaws.com/019cb3cc-d799-7017-a219-58d0d310083b/articles/01a1784c-0e4b-73f6-8260-9e3cb6cd698c/07cc2348-5e4e-4b86-a15d-e2953874ca64.png)

### Rename a category

Hover over the category, open **Category actions** (`···`), and choose **Rename**. Edit the inline name, then press **Enter** or leave the field to save it. Renaming the display name does not regenerate its existing URL slug.

The same category menu includes **New article** and **Delete**. For creating and formatting an article, see [Write and edit articles in your Knowledge Base](https://docs.weav.com/knowledge-bases/write-and-edit-articles-in-your-knowledge-base).

### Choose a category for a new article

When you start a new article, the category picker lists the categories in the section you are adding to, plus **+ New category**.

- If the section already has an **Uncategorized** category (for example, one created when you moved an article into a section with no categories), the picker shows that category once and selects it by default. The article is saved into that existing category.
- If the section has no **Uncategorized** category, the picker shows a single **Uncategorized** option, which saves the article without a category.

## Move an article to another section

1. Hover over the article and open **Article actions** (`···`).
2. Choose **Move to**.
3. Choose the destination section, then a category inside it. If the section has no categories, choose the section itself.
4. Wait for the confirmation, such as **Moved to Product guides › Projects**.

The article is appended to the destination category. Switch to that section if you want to place it at a more specific position afterward.

![The Article actions menu in a fictional Acme workspace, showing Move to, the Product guides section, and its Projects category as the destination.](https://weav-prod-kb-assets.s3.us-east-1.amazonaws.com/019cb3cc-d799-7017-a219-58d0d310083b/articles/01a1784c-0e4b-73f6-8260-9e3cb6cd698c/eacc1091-d569-426e-a853-d3cd61d8edab.png)

Things to know:

- The menu lists every section and its categories, except the article's current category. **Move to** may not appear if there is no other destination.
- A section without categories can be selected directly. The article moves into that section's **Uncategorized** category, and the confirmation reads, for example, **Moved to Product guides › Uncategorized**.
- After a successful menu move, the sidebar stays on the section you were viewing, even if you moved the open article. Opening another article lets the sidebar follow that article's section again.
- A move is not a publication action: a draft remains a draft and a published article remains published.

<Warning>
  **Check public links when changing sections.** An article's own slug can stay the same while its section-based public path changes. Reordering is different from changing the content structure. Review the resulting addresses, navigation, and shared links rather than assuming every old address will continue to work.
</Warning>

## Rename an article or shorten its sidebar label

To change an article title:

1. Open **Article actions → Rename**.
2. Enter the new title in **Rename article**.
3. Select **Save changes**.

The article's existing URL slug stays the same. Empty titles are rejected; select **Cancel** to keep the existing title.

A custom **Sidebar title** can override the label shown in navigation. To change only that shorter label, open the article's Settings and edit Sidebar title instead. If a renamed article still shows its old navigation label, check that field.

## Create, reorder, and manage sections

If your Knowledge Base has no sections yet, select the **+** button at the top of the Content sidebar and choose **New article** or **New section**. After you create a section, Weav opens it in the Content sidebar.

Once you have sections, open the **section picker** above the content tree:

- Choose **New section**, enter its name, and create it to add another top-level area.
- Choose **Manage sections** to see the full section list.

Once sections exist, the **+** button at the top creates a new article directly.

In **Manage sections**:

- **Reorder:** drag a section row into the desired position. The new order saves when dropped.
- **Rename:** select its pencil control, edit the name, then press Enter or leave the field to save. Press Esc to cancel. You can type spaces in the name, such as "Reference Hub". A display-name change does not regenerate the existing section slug.
- **Delete:** select its delete control and review the confirmation before proceeding.
- **Done:** close the dialog. This is not a separate Save all action; completed operations have already been submitted.
- **New section:** open the new-section dialog.

![The Manage sections dialog for a fictional Acme Knowledge Base, showing Help center, Product guides, and Integrations with rename and delete controls.](https://weav-prod-kb-assets.s3.us-east-1.amazonaws.com/019cb3cc-d799-7017-a219-58d0d310083b/articles/01a1784c-0e4b-73f6-8260-9e3cb6cd698c/d4614120-cce5-4dc6-9d7e-24131db9d552.png)

## Delete containers without losing track of articles

Use deletion carefully. Removing a container and removing an article have different results:

| Action | Result |
| --- | --- |
| **Delete a category** | Its articles become **Uncategorized**. The articles themselves are not deleted. Review pending suggestions that used the category before publishing them. |
| **Delete a section** | Its categories appear in the first remaining section. Their articles remain in those categories. |
| **Delete an article** | The article is removed. Its confirmation warns that the action cannot be undone in this workflow. |

Deleting a section or category does **not** unpublish its articles or make their content private. Reorganize useful content before deleting containers, and treat article deletion as a removal decision—not a shortcut for changing navigation.

<Tip>
  **Use names readers recognize.** Put first-time tasks near the top, group related answers, and choose descriptive labels. After a substantial reorganization, check the public site on desktop and mobile, including links to moved articles.
</Tip>

## Troubleshoot organization changes

### Why is Move to missing?

The menu needs at least one destination: a section or a category other than the article's current one. Add the required section or category before trying again.

### Why did an article disappear from the current section?

Check its destination category and the section picker. Moving an article to a category in another section, or deleting a section, can remove it from the section you were viewing. These actions do not necessarily delete the article.

### Why did the order go back?

If the save fails, the sidebar can restore the previous arrangement. Check the error, reload to see the saved state, and retry once the issue is resolved. Generated API-reference articles are managed from their source and may prevent manual reordering of their group.

### Why does public navigation look different?

Check article and translation publication states, the selected language, and whether the Knowledge Base is live. Reordering does not publish drafts. See [Go live with your Knowledge Base](https://docs.weav.com/knowledge-bases/go-live-with-your-knowledge-base).

If you maintain documentation through GitHub, coordinate structural changes with that workflow and review any resulting repository changes. See [Connect GitHub to your Knowledge Base](https://docs.weav.com/knowledge-bases/connect-github-to-your-knowledge-base).

---

This knowledge base is built and hosted on [Weav](https://weav.com).
