Content Management

Welcome to the Content Management guide for Webdocs. This guide will walk you through everything you need to know to organize, create, and edit your documentation effectively.

Webdocs offers two powerful ways to manage your content:

The Admin Console (For deep structural management)
The Frontend Editor (For quick, on-the-fly editing directly from the live site)

1. Managing Workspaces (Spaces)

Spaces allow you to host multiple distinct documentation projects under a single Webdocs installation (e.g., "API V1", "User Manual", "Internal Docs").

Creating a New Space

Go to the Admin Console and click on Spaces from the left sidebar.
In the right column, locate the New Space card.
Fill in the details:
- Space Name: The display title (e.g., API Documentation).
- URL Slug: The web address (e.g., api-docs).
- Language: Primary language for AI optimization.
Click Create Workspace.

Screenshot 2026-03-09 192024.png

Customizing a Space

Click the Config button next to any Space to upload custom logos (Light/Dark mode), a Favicon, and a meta description specifically for that project.

2. Admin Console: Pages & Menus

If you prefer a traditional backend experience, you can manage your pages directly from the Admin Console.

Creating a Page

Navigate to Create Page in the Admin sidebar.
Select your Target Workspace from the top-right dropdown.
Enter a URL Slug (e.g., getting-started).
Select a Menu Category (or create a new one).
Write your content in the Markdown Editor.
Click Publish Page.

Organizing the Menu (Drag & Drop)

The Menu Manager allows you to structure how your documentation appears to users.

Go to Menu Manager.
To create a new group/category, type a name in the Add Group input and click Add.
Drag and Drop pages from the "Uncategorized" list into your groups.
Reorder groups or pages by grabbing the dotted :: handle.
Click Save Changes at the top right to apply the new menu structure to the live site.

Screenshot 2026-03-09 192131.png

3. Frontend Management (Live Editing)

One of the most powerful features of Webdocs is the ability to manage content while browsing the live site. As long as you are logged in as an Admin, you will see hidden management tools right on the public pages.

How to Edit the Current Page

Whenever you are viewing a page, look at the top right corner near the print icon.

Click the Edit Page button.
The page will instantly transform into a split-pane Markdown editor.
Make your changes and see them instantly in the "Preview" tab.
Click Save Changes to publish immediately.

Screenshot 2026-03-09 192539.png

Using the Sidebar to Manage Content (Hover & Touch)

The left navigation sidebar on the live site acts as a mini-management console for admins.

On Desktop: Simply hover your mouse over a Category name or a Page name.
On Mobile/Tablet: Tap/Touch the category or page to reveal the hidden icons.

When you hover/touch, two icons will appear:

➕ Plus Icon: Click this next to a Category to instantly create a new page inside that specific category.
✏️ Pencil Icon: Click this to rename the Category, or to change a Page's URL slug and move it to a different group.

Example: Moving a Page from the Frontend

Hover over a page in the sidebar.
Click the ✏️ Pencil Icon.
A modal will pop up. Click Move to select a new category.
Click Save Changes. The page moves instantly without needing to visit the Admin Dashboard!

Screenshot 2026-03-09 192250.png

Screenshot 2026-03-09 192353.png

4. The AI Writing Assistant

While using the Frontend Editor (after clicking "Edit Page"), you will notice a floating Sparkle Button (✨) at the bottom right of the screen.

Click the ✨ button to open the AI Assistant Sidebar.
Ask the AI to rewrite a paragraph, fix grammar, or generate a code block.
If you ask the AI to "Rewrite this page", it will generate the new markdown and automatically update your editor!
Choose the context mode: Tell the AI to focus only on the "Current Page" or search the "Full Project" for answers.

Screenshot 2026-03-09 192657.png

Page Title