Skip to main content

Overview

Pages provide a powerful space for capturing ideas, documenting decisions, creating meeting notes, and building project documentation. With a rich text editor, AI capabilities, and seamless integration with issues, Pages serve as your project’s knowledge base.
Think of Pages as collaborative documents that live alongside your work items, perfect for specs, meeting notes, and team documentation.

Creating a Page

Start a new page:
1

Navigate to Pages

Go to your project and click “Pages” in the sidebar.
2

Create New Page

Click “New Page” to create a blank page or use a template.
3

Start Writing

Add a title and start creating content with the rich text editor.

Rich Text Editor

The Pages editor provides comprehensive formatting capabilities:

Text Formatting

- **Bold** and *italic* text
- Headings (H1, H2, H3, H4, H5, H6)
- Bulleted and numbered lists
- Blockquotes
- Strikethrough
- Inline code

Editor Toolbar

Quick access to formatting options:

Typography

  • Paragraph
  • Headings 1-6
  • Quote

Text Style

  • Bold
  • Italic
  • Underline
  • Strikethrough
  • Code

Lists

  • Bullet list
  • Numbered list
  • Task list

Insert

  • Link
  • Image
  • Code block
  • Table

Alignment

  • Align left
  • Align center
  • Align right

Colors

  • Text color
  • Highlight
Use keyboard shortcuts to format text quickly. Most standard Markdown shortcuts work in the editor.

AI Capabilities

Pages include AI-powered features to enhance your writing:

AI Assistant Features

Content Generation

Generate content from prompts or expand brief notes into full sections

Improve Writing

Enhance clarity, grammar, and tone of existing content

Summarize

Create concise summaries of longer content sections

Continue Writing

Get AI suggestions to continue your thought or complete paragraphs
AI-generated content should be reviewed and edited. Use AI as a writing assistant, not a replacement for your expertise.

Page Organization

Page Properties

- Title: Page name
- Created by: Original author
- Created date: Page creation timestamp
- Last updated: Most recent modification
- Updated by: Last person to edit
The navigation pane provides quick access to:

Outline

Auto-generated table of contents based on headings

Info

Page metadata, version history, and document stats

Assets

All images and files attached to the page

Page Tabs and Filters

Organize and find pages easily:

Page Tabs

Complete list of all project pages including archived ones

Search and Filter

// Filter pages by:
- Access (Public, Private)
- Created by (specific team members)
- Date (created or updated)
- Favorites
- Archived status

// Sort pages by:
- Recently updated
- Recently created
- Alphabetically

Converting to Issues

Turn page content into actionable work items:
1

Select Content

Highlight text or select a task list item in your page.
2

Convert to Issue

Click the “Create Issue” button or use the context menu.
3

Configure Issue

The selected content becomes the issue description. Add properties and save.
Use this feature during brainstorming or planning sessions to quickly convert ideas into tracked work items.

Version History

Track changes over time:
Page versions are automatically saved, allowing you to view historical versions and restore previous content if needed.
// Version history features:
- View all historical versions
- See who made each change
- Compare versions side-by-side
- Restore previous versions
- Track content evolution

Collaboration Features

Real-time Editing

Multiple team members can edit the same page simultaneously with live updates

Comments

Add comments on specific content sections for discussion and feedback

Mentions

Tag team members with @mentions to notify them about specific sections

Activity Feed

Track all changes, comments, and edits in the page activity log

Page Actions

Manage pages with quick actions:
// Available page operations:
- Edit page content
- Duplicate page
- Export page (Markdown, PDF)
- Archive page
- Delete page
- Copy page link
- Add to favorites
- Change access settings

Keyboard Shortcuts

ActionShortcut (Mac)Shortcut (Windows/Linux)
Create pagePP
BoldCmd+BCtrl+B
ItalicCmd+ICtrl+I
LinkCmd+KCtrl+K
Heading 1Cmd+Alt+1Ctrl+Alt+1
Heading 2Cmd+Alt+2Ctrl+Alt+2
Code blockCmd+Alt+CCtrl+Alt+C
Bullet listCmd+Shift+8Ctrl+Shift+8
Numbered listCmd+Shift+7Ctrl+Shift+7

Use Cases

Meeting Notes

Capture decisions, action items, and discussion points from team meetings

Technical Specs

Document technical requirements, architecture decisions, and implementation details

Product Requirements

Write detailed PRDs with user stories, acceptance criteria, and design specs

Retrospectives

Document sprint retrospectives with what went well, improvements, and action items

Onboarding Docs

Create guides and documentation for new team members

Decision Logs

Record important project decisions and their rationale for future reference

Best Practices

Use Descriptive Titles

Name pages clearly so team members can quickly find relevant documentation.

Leverage Headings

Use heading hierarchy (H1, H2, H3) to create structure and enable the outline navigation.

Link Related Content

Connect pages to related issues, other pages, and external resources for context.

Keep Pages Focused

Create separate pages for different topics rather than one massive document.

Archive Outdated Content

Archive pages that are no longer relevant to keep the active page list clean.

Regular Review

Schedule periodic reviews to update pages and ensure information stays current.

Code Example

Creating a page programmatically:
const pageData = {
  name: "Sprint 24 Retrospective",
  description_html: `
    <h1>Sprint 24 Retrospective</h1>
    
    <h2>What Went Well</h2>
    <ul>
      <li>Delivered all committed stories</li>
      <li>Improved test coverage to 85%</li>
    </ul>
    
    <h2>What Could Be Improved</h2>
    <ul>
      <li>Better estimation for backend tasks</li>
      <li>Earlier design feedback in the sprint</li>
    </ul>
    
    <h2>Action Items</h2>
    <ul class="task-list">
      <li><input type="checkbox" /> Schedule design reviews at sprint start</li>
      <li><input type="checkbox" /> Create estimation guide for backend work</li>
    </ul>
  `,
  access: "public",
  is_favorite: false
};
  • Issues - Convert page content to work items
  • Cycles - Document sprint retrospectives and planning
  • Modules - Create module-specific documentation
  • Views - Link to views in page documentation

Build docs developers (and LLMs) love