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

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

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

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.

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:

Keyboard Shortcuts

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:
  • 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