Skip to main content

Managing Pages

Your documentation is organized into pages grouped by categories in the sidebar. You manage all of this through the AI agent -- there are no manual file operations required.

Page Structure

Every page belongs to a category. The default categories in a Docsio project are:

  • getting-started
  • features
  • api-reference
  • guides
  • integrations

Pages are listed in the sidebar under their category, ordered by position. The sidebar updates automatically whenever pages are added, removed, or reordered.

Adding a Page

Ask the agent to create a new page and specify which category it should belong to:

Add a new page about authentication in the Guides section
Create an API reference page for the /users endpoint

The agent will create the page with initial content, assign it to the correct category, and update the sidebar.

Renaming a Page

To change a page title:

Rename the "Quickstart" page to "Getting Started"

The agent updates both the page title and the sidebar entry.

Deleting a Page

To remove a page from your project:

Remove the troubleshooting page
warning

Deleting a page removes it permanently from the project. There is no undo. If you are unsure, consider asking the agent to move the content to another page first.

Reordering Pages

To change where a page appears in the sidebar:

Move the Installation page to the top of Getting Started
Put the FAQ page at the end of the sidebar

The agent adjusts the page positions within the category, and the sidebar reflects the new order immediately in the preview.

Working with Categories

Pages are organized by category, and each category appears as a collapsible group in the sidebar. When you ask the agent to add a page, specify the category to control where it appears:

Add a "Webhooks" page under the API Reference category

If you do not specify a category, the agent will place the page in the most relevant section based on the content.

tip

You can see all your pages and their categories in the file tree on the left side of the editor. Click any page to select it and view its content in the preview.