How to use document navigation in Vaiz


For the basics of creating and editing documents, see How to create and work with documents in Vaiz. In this guide, we’ll focus on document navigation and the widgets that help connect related pages.

These tools are useful when one topic grows into several documents, and readers need a quick way to move through the structure without returning to the sidebar each time.

Step 1. Create connected documents

Open the three-dot menu next to a document in the left sidebar.

Document sidebar menu with Create sub document, next sibling, and previous sibling options

From here, you can create:

  • Sub document — creates a nested document inside the current one
  • Next sibling — creates the next document at the same level
  • Previous sibling — creates the previous document at the same level
Sidebar showing the Previous sibling, Sub document, and Next sibling created around Document navigation

Step 2. Use Siblings navigation

The Siblings navigation widget helps you move between previous and next documents.

To add it:

  1. Open a document
  2. Type “/”
  3. Select Siblings navigation
Slash command menu with the Siblings navigation option highlighted

The widget displays links to sibling documents and lets you quickly switch between them.

Siblings navigation block showing Previous and Next document links

Note: this widget is available only inside documents.

Step 3. Use Document tree

The Document tree widget shows subdocuments connected to the current document, including nested levels.

To add it:

  1. Open a document
  2. Type “/”
  3. Select Document tree
Slash command menu with the Document tree option highlighted

The widget creates a clickable structure of child documents, so you can open related pages directly from the document.

Document tree block showing nested links to sub document and sub next sibling

Step 4. Use Table of contents

If a document contains headings, you can generate navigation for them automatically.

To add it:

  1. Open a document
  2. Type “/”
  3. Select Table of contents
Slash command menu with the Table of contents option highlighted, based on headers

The widget displays all headings from the document. Clicking a heading moves you directly to that section.

Table of contents block listing links to three headings above the matching sections

Step 5. Duplicate documents with or without subdocuments

You can duplicate a single document or copy it together with its subdocuments.

In the left sidebar, open the document menu and choose one of the options:

  • Duplicate – to copy only the selected document
  • Duplicate with sub documents – to copy the document together with its nested structure
Document menu with Duplicate and Duplicate with sub documents highlighted

The duplicated copy appears in the same document section.

Sidebar showing the duplicated document copy along with its sub documents

This is useful when you want to reuse an existing setup without rebuilding it from scratch.