Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 12 additions & 6 deletions docs/ai/pi-chat.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Plane AI
title: AI powered assistant for project management
sidebar_label: Plane AI
hide_title: true
description: Plane AI is your intelligent assistant for finding project data, analyzing work items, and managing tasks using natural language.
---
Expand Down Expand Up @@ -28,6 +29,12 @@ Plane AI excels at finding and analyzing information from your Plane workspace:
- Access official Plane documentation and feature guides.
- Cross-project discovery to find related content across multiple projects

**Creation and management**

- Create work items through natural language commands
- Generate projects, cycles, and modules with AI assistance
- Automatically populate properties and descriptions based on context

**Data analysis and insights**
- Analyze project progress and team performance with real-time queries.
- Generate reports on work item status and trends using complex filtering and aggregations
Expand All @@ -45,10 +52,10 @@ Plane AI excels at finding and analyzing information from your Plane workspace:

## What Plane AI cannot do (yet)

Plane AI is currently **read-only**. It cannot perform actions that modify your workspace:
While Plane AI can now create and edit work items, projects, cycles, and modules, some capabilities are still in development:

- ❌ Execute automated task workflows.
- ❌ Handle bulk operations or routine project management tasks.
- ❌ Execute complex automated workflows
- ❌ Handle bulk operations across multiple items simultaneously

## How to use Plane AI

Expand Down Expand Up @@ -237,9 +244,8 @@ Plane AI is continuously learning and improving. The more you use it, the better
## What's coming next

We're actively working on expanding Plane AI's capabilities:
- **Action execution**: Create and update work items through conversation
- **Advanced action execution**: Handle bulk operations
- **Advanced workflows**: Automate routine project management tasks
- **Voice interface**: Speak your queries instead of typing
- **Enhanced analytics**: Predictive insights and recommendations

Plane AI represents the future of project management, where natural conversation replaces complex interfaces, and your AI assistant helps you focus on what matters most: building great products.
5 changes: 3 additions & 2 deletions docs/ai/plane-ai-credits.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: AI credits
title: How AI credits work for team usage and billing
sidebar_label: AI credits
hide_title: true
description: Learn how Plane AI's credit system works, why different tasks consume different amounts, and how workspace pooling helps teams manage AI usage efficiently.
---
Expand Down Expand Up @@ -33,7 +34,7 @@ Here's how these factors translate into typical usage:
| --- | --- | --- |
| **Short query** | ~10 credits | Quick questions, status checks, brief clarifications |
| **Long query** | ~50 credits | Detailed explanations, code generation, analytical responses |
| **Action** | ~100 credits | Creating or editing multiple issues, generating project structures |
| **Action** | ~100 credits | Creating or editing multiple work items, generating project structures |
| **Heavy action** | ~250 credits | Bulk operations, file analysis, complex workflow automation |

To illustrate with a real workflow:
Expand Down
3 changes: 2 additions & 1 deletion docs/automations/custom-automations.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Automations
title: Automate project tasks with trigger based workflows
sidebar_label: Automations
hide_title: true
description: Automate repetitive project tasks with trigger-based workflows. Set up rules to automatically update work item properties, assign team members, and manage priorities when specific conditions are met.
---
Expand Down
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Work Item Comments
title: Comments for collaboration and activity tracking
sidebar_label: Work Item Comments
description: Add comments, mention team members, and track activity on work items
---

Expand Down
3 changes: 2 additions & 1 deletion docs/communication-and-collaboration/project-updates.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Project Updates
title: Project updates to share status and track progress
sidebar_label: Project Updates
description: Share project status and track progress over time
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/account/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Personalize homepage
title: Personalize your homepage
sidebar_label: Personalize homepage
description: Customize your Home page with quick links, recent activity, and sticky notes to create a personalized dashboard for improved productivity.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/analytics.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Analytics
title: Analytics to visualize work data and track performance
sidebar_label: Analytics
description: Visualize work item data, track team capacity, measure progress, and create custom charts.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/cycles.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Cycles
title: Manage sprints and track agile workflows
sidebar_label: Cycles
description: Create and manage sprints using Cycles in Plane. Track progress, transfer incomplete tasks, and monitor active cycles across projects for efficient Agile workflows.
---

Expand Down
2 changes: 1 addition & 1 deletion docs/core-concepts/deploy.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
---
title: Publish project
title: Publish projects
description: Publish your projects as public boards with customizable layouts, commenting, and voting features. Share your roadmap with zero setup on a free domain.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/export.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Export
title: Export work items from project
sidebar_label: Export
description: Export work items from Plane in CSV, Excel, or JSON formats for backup, analysis, or sharing.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/inbox.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Inbox
title: Inbox for in app notifications and work item updates
sidebar_label: Inbox
description: Use Inbox to monitor task updates, filter notifications, and manage mentions.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/intake.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Intake
title: Intake to collect and triage external work requests
sidebar_label: Intake
description: Use Intake feature to collect, triage, and manage external work item submissions from stakeholders, clients, and guests before adding them to your workflow.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/issues/bulk-ops.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Bulk Ops
title: Bulk update multiple work items to save time
sidebar_label: Bulk Ops
hide_title: true
description: Learn how to save time by updating multiple work items at once in Plane. Change states, priorities, assignees, dates, and more with efficient bulk operations.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/issues/display-options.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Display options
title: Display options for viewing work items
sidebar_label: Display options
description: Customize display by showing specific properties, grouping by attributes, subgrouping, and ordering items to create the perfect project view.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/issues/epics.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Epics
title: Organize related work items with Epics
sidebar_label: Epics
hide_title: true
description: Create and manage Epics in Plane to organize related work items, track progress across multiple tasks, and align your team around larger objectives.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/issues/estimates.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Estimates
title: Task estimates using points, time or categories
sidebar_label: Estimates
description: Set up and customize work item estimation using points, categories, or time to quantify task complexity and effort.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/issues/labels.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Labels
title: Categorize and tag project tasks
sidebar_label: Labels
description: Use labels to categorize work items, simplify filtering, and organize tasks by component, feature, or custom attributes beyond standard properties.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/issues/layouts.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Layouts
title: Project layouts
sidebar_label: Layouts
toc_max_heading_level: 2
description: Use layouts to visualize, organize, and manage your work items based on your team's workflow preferences.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/issues/time-tracking.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Time Tracking
title: Time tracking to log hours on tasks
sidebar_label: Time Tracking
hide_title: true
description: Log hours on work items, view timesheet records, and download comprehensive reports for project time management.
---
Expand Down
4 changes: 2 additions & 2 deletions docs/core-concepts/issues/timeline-dependency.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,13 @@
---
title: Timeline dependencies
title: Task dependencies
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🟠 Major

🧩 Analysis chain

Title change reduces specificity and may impact discoverability.

The title changed from "Timeline dependencies" to "Task dependencies," which is now generic despite the content being specific to Timeline layout. This creates a mismatch with:

  • The filename: timeline-dependency.mdx
  • The description: mentions "Timeline layout" explicitly
  • The entire content: discusses only Timeline layout connectors and features

If task dependencies exist in other layouts (Board, List, etc.), this title could create confusion about scope. Users searching for "timeline dependencies" may not find this page.

Please verify: Do other layouts (Board, List, etc.) support task dependencies? If so, consider retaining the specificity:

-title: Task dependencies
+title: Timeline dependencies

Alternatively, if this page truly covers dependencies across all layouts, ensure the content and heading accurately reflect that broader scope.


I'll search the codebase to verify whether task dependencies are supported in other layouts beyond Timeline.

[/run_scripts]


🏁 Script executed:

#!/bin/bash
# Find all documentation files mentioning task dependencies or dependencies in general
echo "=== Searching for task dependency documentation ==="
find docs -type f \( -name "*.mdx" -o -name "*.md" \) -exec grep -l "task.*dependen\|dependen.*task\|dependencies.*layout" {} \; 2>/dev/null | head -20

echo ""
echo "=== Searching for Board/List layout documentation files ==="
find docs -type f \( -name "*.mdx" -o -name "*.md" \) | grep -E "(board|list|layout)" | head -20

echo ""
echo "=== Checking for any references to timeline-dependency content in other docs ==="
rg -l "timeline.*depend|task.*depend" docs --type mdx --type md 2>/dev/null

echo ""
echo "=== Listing all files in docs/core-concepts/issues ==="
ls -la docs/core-concepts/issues/ 2>/dev/null

Length of output: 1433


I need to examine the layouts.mdx and overview.mdx files to understand the scope of task dependency support.

[/run_scripts]


🏁 Script executed:

#!/bin/bash
# Read layouts.mdx to check what it says about Board/List layout features
echo "=== Content of layouts.mdx ==="
cat docs/core-concepts/issues/layouts.mdx

echo ""
echo "=== Content of overview.mdx (focusing on dependencies section) ==="
cat docs/core-concepts/issues/overview.mdx | head -100

Length of output: 11988


Title change removes critical specificity—task dependencies are Timeline-exclusive.

Verification confirms that task dependencies (visual connectors) are a Timeline layout feature only. Other layouts (List, Board, Calendar, Table) do not support this feature. The documentation explicitly states: "Go for Timeline when managing dependencies or seeing the big picture."

The title change from "Timeline dependencies" to "Task dependencies" creates a harmful mismatch:

  • Filename remains: timeline-dependency.mdx
  • Content covers: Timeline layout only
  • New title suggests: Feature applies across all layouts
  • Result: Users searching for "timeline dependencies" won't find this page; generic title could mislead about scope

The heading change to "Set up task dependencies in Timeline layout" correctly adds specificity, but the title should also be restored to maintain consistency and discoverability.

Revert the title change:

-title: Task dependencies
+title: Timeline dependencies
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
title: Task dependencies
title: Timeline dependencies
🤖 Prompt for AI Agents
In docs/core-concepts/issues/timeline-dependency.mdx around line 2, the
frontmatter title was changed from "Timeline dependencies" to the generic "Task
dependencies" which misrepresents scope and hurts discoverability; revert the
frontmatter title back to "Timeline dependencies" so it matches the filename and
content, and ensure the visible H1 remains "Set up task dependencies in Timeline
layout" if desired for specificity.

hide_title: true
description: Create and manage visual task dependencies in Plane with timeline connectors.
---

import Tags from "@site/src/components/Tags";

<div className="tag-wrapper">
<h1>Set up task dependencies visually</h1>
<h1>Set up task dependencies in Timeline layout</h1>
<Tags tags={[{ name: "Pro", link: "https://plane.so/pricing", additionalClass: "pro" }]} />
</div>

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/issues/visualise_filter.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Work Item Filters
title: Filter work items
sidebar_label: Work Item Filters
description: Learn how to filter work items in Plane.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/modules.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Modules
title: Organize project features with Modules
sidebar_label: Modules
description: Use Modules to organize work items, track feature development, and break down projects into manageable components with progress tracking and multiple layouts.
---

Expand Down
7 changes: 6 additions & 1 deletion docs/core-concepts/pages/editor-blocks.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Editor blocks
title: Editor blocks for pages
sidebar_label: Editor blocks
description: Explore all available content blocks in Plane's Page editor.
---

Expand Down Expand Up @@ -121,6 +122,10 @@ Both equation types support full LaTeX rendering with built-in validation and er
/>
</div>

:::tip[Prerequisites]
Before you can add Draw.io diagrams to Pages or Wiki, you need to [connect the Draw.io integration](/integrations/draw-io) from Workspace Settings.
:::

Create and manage interactive diagrams and whiteboards directly within your Pages using the integrated Draw.io editor. Whether you need professional flowcharts, system architecture diagrams, or freehand sketches for brainstorming, the diagram feature provides powerful visual documentation capabilities without leaving Plane.

![Draw.io diagram](https://media.docs.plane.so/pages/draw-io-diagram.webp#hero)
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/pages/inline-comments.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Page Inline Comments
title: Inline comments for collaborative page discussions
sidebar_label: Page Inline Comments
hide_title: true
description: Collaborate directly in Plane pages with inline comments. Highlight text, mention teammates, and resolve discussions across projects, wikis, and teamspaces.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/pages/nested-pages.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Nested Pages
title: Nested pages for hierarchical documentation structure
sidebar_label: Nested Pages
hide_title: true
description: Create structured documentation with Nested Pages. Build parent-child hierarchies, organize content logically, and improve navigation for your team's knowledge base.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/pages/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Manage project pages
title: Pages for project documentation
sidebar_label: Manage project pages
description: Create, format, and share project documentation with AI assistance, content blocks, version history, and web publishing options.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/pages/wiki.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Wiki
title: Wiki for company wide knowledge base
sidebar_label: Wiki
hide_title: true
description: Create and organize company-wide documentation, policies, guides, and knowledge that extends beyond individual projects.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/projects/initiatives.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Initiatives
title: Align multiple projects with Initiatives
sidebar_label: Initiatives
hide_title: true
description: Create and manage Initiatives to align multiple projects with strategic goals, track cross-project epics, and monitor aggregated progress.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/projects/manage-project-members.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Manage members
title: Manage project members
sidebar_label: Manage members
description: Add members to projects, assign roles, and configure access
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/projects/milestones.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Milestones
title: Align work toward target dates with Milestones
sidebar_label: Milestones
hide_title: true
description: Align work items toward shared completion dates with milestones. Track progress on quarterly objectives, product launches, and strategic initiatives in Plane.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/projects/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Manage projects
title: Create and manage projects
sidebar_label: Manage projects
description: Create and manage projects, configure settings, add team members, and enable features.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/projects/recurring-work-items.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Recurring Work Items
title: Recurring work items to automate repetitive tasks
sidebar_label: Recurring Work Items
hide_title: true
description: Learn how to set up recurring work items to automatically create repetitive tasks, maintenance schedules, and routine work on a predefined schedule.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/stickies.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Stickies
title: Quick notes and reminders for project tasks
sidebar_label: Stickies
description: Use Stickies in Plane to capture quick ideas, reminders, and notes without leaving your workspace.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/views.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Views
title: Save custom views for filtered work items
sidebar_label: Views
description: Create, save, and share Views in Plane to quickly access filtered work items.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/workspaces/members.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Manage members
title: Manage workspace members
sidebar_label: Manage members
description: Add, update, and remove workspace members
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/workspaces/overview.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Manage workspace
title: Create and manage workspaces
sidebar_label: Manage workspace
description: Create and manage Workspaces in Plane.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/core-concepts/workspaces/teamspaces.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Teamspaces
title: Track team work with Teamspaces
sidebar_label: Teamspaces
hide_title: true
description: Organize team members across projects, track team-specific work items, and create dedicated spaces for team knowledge and collaboration.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/customers.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Customers
title: Customer management to track client requests and priorities
sidebar_label: Customers
hide_title: true
description: Track client requests, link work items to specific customers, and prioritize tasks based on customer importance.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/dashboards.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Dashboards
title: Custom dashboards to visualize project metrics and data
sidebar_label: Dashboards
hide_title: true
description: Build custom dashboards in Plane to visualize project metrics.
---
Expand Down
3 changes: 2 additions & 1 deletion docs/devices/mobile.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Mobile
title: Project management mobile app for iOS and Android
sidebar_label: Mobile
description: Learn how to use Plane's mobile app for iOS and Android.
---

Expand Down
3 changes: 2 additions & 1 deletion docs/importers/asana.mdx
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: Asana
title: Import data from Asana
sidebar_label: Asana
description: Migrate your Asana data to Plane.
---

Expand Down
Loading