Create Wiki Page

Create new wiki pages to document knowledge, processes, and technical specifications. Pages can be root-level documents or nested subpages, supporting deep hierarchical organization for complex documentation needs.

Creating a Root Page

Root pages appear at the top level of your wiki tree.

From the Sidebar

1. Click "Create Page" button at the top of the sidebar
2. The create modal opens
3. Enter page title in the required field
4. Optionally add initial content
5. Click Create

From Empty State

When wiki has no pages:

1. See empty state message
2. Click "Create your first page"
3. Complete the creation modal
4. Your first page is ready

Creating a Subpage

Subpages nest under existing pages, building hierarchical documentation.

From Page Tree

1. Hover over the parent page in sidebar tree
2. A "+" icon appears on the right
3. Click the "+" icon
4. Modal opens with parent context
5. Enter subpage title
6. Click Create

The new page nests under the parent in the navigation tree.

Parent Context

When creating a subpage, the modal shows:

• Parent page title
• Visual indicator of nesting
• Confirmation of hierarchy

This helps confirm you're creating at the correct location.

Modal Fields

Page Title (Required)

Purpose: The name that appears in navigation and as the page heading.

Guidelines:

• Descriptive and specific
• 3-100 characters
• Avoid special characters that may cause URL issues
• Use consistent naming conventions

Good examples:

• "API Authentication Guide"
• "Deploying to Production"
• "Sprint 23 Retrospective Notes"

Avoid:

• Single words like "Notes" (too generic)
• Very long titles (truncate in navigation)
• Duplicating existing page names

Initial Content (Optional)

Purpose: Start the page with content instead of blank.

Format: Plain text or Markdown-style formatting.

Use cases:

• Paste existing content
• Start from template
• Quick notes to expand later

If left blank, page creates empty—you can add content in edit mode after creation.

After Creation

Immediate Navigation

After clicking Create:

1. Modal closes
2. New page appears in tree
3. Page content loads in center
4. You can immediately start editing

Empty Page View

New pages with no initial content show:

• Page title as heading
• Empty content area
• Edit button to add content

Edit Mode

To add content after creation:

1. Click "Edit Page" in right sidebar
2. Page enters edit mode
3. Add your content
4. Click Save

Page Organization

Choosing Location

Before creating, decide hierarchy:

Root page when:

• Major documentation category
• Standalone reference
• Index or hub page

Subpage when:

• Related to existing page
• Part of larger topic
• Detailed expansion of parent

Restructuring Later

Pages can be moved after creation:

• Drag and drop in tree (if enabled)
• Edit page to change parent
• Create new page and copy content

Depth Considerations

While unlimited nesting is supported:

• 2-3 levels is typically sufficient
• Deep nesting makes navigation harder
• Use cross-links instead of deep trees

Templates

Creating Template Pages

Set up reusable templates:

1. Create page named "[Template] Meeting Notes"
2. Add structure with placeholders
3. When needed, copy template content to new page

Template Suggestions

Meeting Notes:

## Date: [DATE]
## Attendees: 
- 

## Agenda
1. 

## Discussion

## Decisions Made

## Action Items
- [ ] 

## Next Meeting:

Technical Spec:

## Overview

## Problem Statement

## Proposed Solution

## Technical Design

## API Changes

## Database Changes

## Testing Strategy

## Rollout Plan

Runbook:

## Purpose

## Prerequisites

## Steps
1. 
2. 
3. 

## Verification

## Rollback

## Escalation

Best Practices

Name Consistently

Establish team conventions:

• "How to..." for guides
• "[Component] Architecture" for tech docs
• "YYYY-MM-DD Meeting" for notes

Start with Structure

Even with initial content empty:

• Plan your headings
• Know what sections needed
• Create outline first

Link on Creation

After creating:

• Link from related pages
• Add to index pages
• Reference in relevant tasks

Set Ownership

Every page should have an owner:

• Responsible for updates
• Answers questions
• Reviews periodically

Permissions

Page creation requires appropriate permissions:

Project settings may further restrict creation.

Troubleshooting

Create button disabled:

• Title field may be empty
• Check required fields
• Verify permissions

Page not appearing in tree:

• Tree may need refresh
• Check for creation errors
• Try navigating away and back

Cannot create subpage:

• Parent page must be valid
• Check permissions
• Ensure parent isn't archived

Title already exists error:

• Page names should be unique within project
• Add specificity to title
• Check for existing similar page

Keyboard Shortcuts