Projects

Projects group related tasks together within a board. They help you organize work by goal, milestone, or any logical grouping.

What is a Project?

A project is:

• A container for related tasks
• A way to track progress toward a goal
• An organizational unit within a board

Project Properties

Computed Properties

These are calculated automatically:

Creating a Project

1. Open a board
2. Click + Add Project (or press N)
3. Enter a project name
4. Press Enter or click Create

With Description

1. Create the project
2. Click the project header to expand
3. Click Add Description
4. Use the rich text editor to add details

Project Limits

Projects count across all boards in your workspace.

Progress Tracking

Automatic Progress

Progress is calculated automatically:

progress = num_tasks_done / num_tasks_total

The progress bar updates in real-time as you complete tasks.

Progress Display

Task Status Counts

Each project shows:

• Open: Tasks not yet started
• In Progress: Tasks being worked on
• Done: Completed tasks

Project Operations

Expanding/Collapsing

Click the project header to toggle the task list:

• Expanded: See all tasks
• Collapsed: See just the header and progress

Reordering Projects

Drag projects to reorder them within a board:

1. Click and hold the drag handle (⋮⋮)
2. Drag to the new position
3. Release to drop

Order persists using LexoRank for stable positioning.

Editing a Project

1. Click the project menu (⋯)
2. Select Edit
3. Update name or description
4. Changes save automatically

Moving to Another Board

1. Click the project menu (⋯)
2. Select Move to Board
3. Choose the destination board
4. Confirm the move

Note: All tasks move with the project.

Deleting a Project

1. Click the project menu (⋯)
2. Select Delete
3. Confirm deletion

The project and all its tasks go to trash for 40 days.

Auto-Archive Feature

Automatically archive completed projects:

1. Go to Settings > Preferences
2. Enable Auto-archive finished projects
3. Set the delay (7-365 days, default 30)

When a project reaches 100% completion and hasn’t been updated within the delay period, it’s automatically moved to trash.

Rich Text Descriptions

Project descriptions support:

• Headings: H1, H2, H3
• Text formatting: Bold, italic, underline, strikethrough
• Lists: Bullet points, numbered lists, checklists
• Code: Inline code and code blocks
• Links: External URLs
• Quotes: Block quotes

The editor uses BlockNote for a modern editing experience.

Project in Kanban View

In Kanban layout, you can filter by project:

1. Switch to Kanban view
2. Use the project filter dropdown
3. Select one or more projects
4. View only those tasks in the kanban board

This helps focus on specific work streams within the broader board.

Linking to Git Repositories

On Pro and Teams plans, link projects to Git repositories:

1. Connect your GitHub account in Settings
2. Open project settings
3. Click Link Repository
4. Select a repository
5. Configure sync options

See Git Integration for details.

Best Practices

Clear Naming

Use descriptive, action-oriented names:

• ✅ “Launch Marketing Campaign”
• ✅ “Implement User Authentication”
• ✅ “Q1 2024 Goals”
• ❌ “Stuff to do”
• ❌ “Project 1”

Right-Size Projects

Projects should be:

• Small enough to complete in a reasonable timeframe
• Large enough to warrant grouping tasks
• Typically 5-50 tasks

Use Descriptions

Add context that helps you and your team:

• Project goals and success criteria
• Key stakeholders
• Important links and references
• Timeline and milestones

Regular Review

• Weekly: Review active projects
• Monthly: Archive completed projects
• Quarterly: Clean up stale projects

Related Topics

• Tasks - Work items within projects
• Kanban View - Visual project management
• Auto-Archive - Automatic cleanup
• Git Integration - Link to repositories