Managing Projects
This chapter covers the detailed management of projects including views, phases, tasks, Gantt charts, team management, and linked data.
Grid/List View Toggle
The Projects module offers two layout options for browsing projects:
- Grid View — projects displayed as visual cards in a grid layout, showing status, health color, team avatars, and date range
- List View — projects displayed in a data table with sortable columns
Toggle between views using the view switcher buttons at the top of the page.

Project Cards
In grid view, each project card displays:
- Project name and color tag
- Status badge (Not Started, In Progress, On Hold, etc.)
- Health indicator (On Track, At Risk, Off Track)
- Team member avatars (first few members)
- Start and end dates
- Progress percentage (based on completed tasks/phases)
Project Detail Page
Click a project to open its detail page, which contains the following tabs:
Overview
A summary panel showing:
- Project description and objectives
- Key dates (start, end, duration)
- Status and health
- Progress bar
- Key metrics (total tasks, completed tasks, overdue tasks)
Phases/Tasks
The structured breakdown of the project into phases and tasks:
Phases are major milestones or stages of the project (e.g., "Planning," "Development," "Testing," "Launch").
Each phase contains:
- Phase name and description
- Start and end dates
- Status
- Tasks assigned to that phase
Tasks within phases:
- Can be created, edited, and completed inline
- Support assignees, due dates, and priorities
- Are the same task entities used throughout the CRM
To add a phase:
- Click Add Phase.
- Enter the phase name, dates, and description.
- Click Save.
To add a task to a phase:
- Click Add Task within the phase.
- Fill in task details.
- Click Save.

Gantt Chart
A visual timeline showing phases and tasks as horizontal bars on a time axis:
- Phases appear as summary bars spanning their date range
- Tasks appear as bars within their phase
- Dependencies are shown as connecting lines between tasks
- Today marker — a vertical line indicating the current date
- Drag to adjust — resize bars to change dates
Use the Gantt chart during project planning and status meetings. It provides the best visual representation of timelines, overlaps, and dependencies.

Team
Manage the project team:
- View team members — see all assigned users with their roles
- Add members — search and add CRM users to the project
- Set roles — assign project roles (Project Manager, Developer, Designer, etc.)
- Remove members — remove users from the project team
Documents
Upload and manage project-related files — specifications, designs, contracts, reports, etc.
Activity
A timeline of all project activity — phase completions, task updates, team changes, and document uploads. See Activity Timeline.
Linked Opportunities
If the project was created from an opportunity:
- A link to the source opportunity appears on the project overview
- Click the link to navigate to the opportunity detail page
- Revenue and deal data from the opportunity is accessible in context
Linking projects to opportunities provides end-to-end visibility from deal to delivery. Reports can track revenue from sale through project completion.