Organizing Pages in Collections

A collection is only as useful as its organization. When pages are arranged logically, readers can find what they need quickly, follow a natural learning path, and feel confident they haven't missed important information. Poor organization, on the other hand, leads to frustrated users and underutilized documentation.

This guide covers every tool Quixli provides for structuring your collection pages — from simple reordering to building multi-level hierarchies.

Reordering Pages

The simplest form of organization is controlling the order pages appear in. Quixli offers several reordering methods:

• Drag and drop: In the collection sidebar, click and hold any page, then drag it to a new position. A blue indicator line shows where the page will land when you release

• Move Up / Move Down: Right-click a page (or click the three-dot menu) and select "Move Up" or "Move Down" for precise, one-step adjustments

• Sort options: Click the sort icon at the top of the collection sidebar to auto-sort pages alphabetically (A–Z or Z–A) or by creation date (newest or oldest first)

• Custom order numbers: For advanced control, open the collection settings and assign specific order numbers to each page. Pages with lower numbers appear first

Pro Tip: If you're planning a sequential guide (like a tutorial series), use numbered prefixes in your page titles — for example, "01. Introduction," "02. Setup," "03. First Steps." This makes the intended order obvious at a glance.

Creating Page Hierarchy

For complex collections, a flat list of pages isn't enough. Quixli supports nesting pages up to three levels deep, creating a parent-child hierarchy that mirrors how readers think about topics.

To create a sub-page:

• Drag a page onto another page: In the sidebar, drag a page and hover it over another page's title. When you see the indent indicator, release to make it a child page

• Use the page menu: Right-click a page and select "Make Sub-page of..." then choose the parent page

• Create directly under a parent: Click the "+" icon that appears when you hover over a parent page in the sidebar

The hierarchy appears as indented items in the sidebar navigation, with expandable/collapsible sections so readers can focus on what matters to them.

Nesting Limit

Quixli supports up to 3 levels of nesting (parent → child → grandchild). Deeper nesting is intentionally not supported to keep navigation simple and scannable.

Using Section Dividers

When your collection covers distinct topic areas, section dividers create visual separation without adding nesting complexity. Sections act as labeled group headers in the sidebar:

• Add a section divider: Click the "+" menu at the top of the sidebar and select "Section Divider." Give it a descriptive label like "Getting Started" or "Advanced Topics"

• Organize pages under sections: Drag pages below a section divider to group them. Pages remain at the same hierarchy level — sections are purely organizational

• Add section descriptions: Click a section divider to add a short description that appears when readers hover over the section label

• Collapse and expand: Readers can click the section header to collapse or expand that group, reducing clutter when browsing large collections

Best Practices for Page Organization

Thoughtful organization pays dividends in reader satisfaction and content discoverability. Keep these principles in mind:

• Follow the reader's journey: Arrange pages in the order a new reader would naturally progress — from overview to details, from setup to usage, from basics to advanced topics

• Keep hierarchy shallow: Two levels of nesting is usually sufficient. If you need three levels, reconsider whether the content should be split into separate collections

• Use descriptive section labels: Sections should immediately tell readers what type of content they'll find — "API Reference" is better than "Section 3"

• Review periodically: As your collection grows, revisit the organization. Pages that made sense in one order may need restructuring as new content is added

• Consider your audience: Technical documentation might benefit from alphabetical reference sections, while tutorials work better in sequential order

Frequently Asked Questions

Can I move pages between collections while preserving their position?

When you move a page to a different collection, it's placed at the end of the new collection's page list by default. You can then drag it to the desired position. The page's content, history, and comments are fully preserved during the move.

What happens to sub-pages if I delete a parent page?

If you delete a parent page, its sub-pages are promoted to the same level as the deleted parent — they won't be deleted. This ensures you never accidentally lose content by removing a structural page.

Is there a limit to how deep the page hierarchy can go?

Quixli supports up to 5 levels of nesting within a collection. In practice, 2–3 levels is ideal for most use cases — deeper nesting makes content harder to navigate. If you need more depth, consider splitting the content into separate collections linked together.

Can I duplicate a page and place it in multiple collections?

Pages can only belong to one collection at a time, but you can create a copy using the page menu's "Duplicate" option and move the copy to a different collection. Changes to the original won't sync to the duplicate — they're independent pages after duplication.

How do I quickly reorder many pages at once?

Select multiple pages by holding Cmd/Ctrl while clicking, then drag the group to the desired position. You can also use the collection settings menu to switch to a list view, which shows numerical position numbers you can edit directly for precise ordering.