diff --git a/docs/core-concepts/projects/project-overview.mdx b/docs/core-concepts/projects/project-overview.mdx
new file mode 100644
index 0000000..c751289
--- /dev/null
+++ b/docs/core-concepts/projects/project-overview.mdx
@@ -0,0 +1,92 @@
+---
+title: Project overview
+hide_title: true
+---
+
+import Tags from '@site/src/components/Tags';
+
+
+# Monitor project progress at a glance
+
+
+
+Without a centralized dashboard, teams often face challenges like fragmented information, inefficient progress tracking, and communication gaps.
+
+Project Overview offers a centralized space for teams to monitor project health, track progress, and collaborate effectively. It consolidates key project metrics, updates, and collaboration tools into a single view. Whether you're a project lead, team member, or stakeholder, this feature provides the visibility you need to stay informed and aligned.
+
+## Access Project Overview
+
+Navigate to **Issues** under your project and click **Overview** on the top bar.
+
+
+
+## Project header
+
+The header includes the project details and quick access to essential actions.
+
+- Add a custom banner and project icon to personalize your dashboard.
+- Write key details about your project plan, goals, and success metrics, helping your team stay aligned and focused.
+- Attach links or resources directly to the dashboard.
+
+
+
+## Project metrics
+You can view overall project completion percentages. Metrics are displayed visually with status bars to help identify bottlenecks.
+
+
+
+This helps to identify overdue tasks and track progress over time. Task status breakdown:
+- **Overdue**: Tasks past their due dates.
+- **Backlog**: Tasks that are planned but not yet prioritized.
+- **Unstarted**: Tasks yet to begin.
+- **Started**: Tasks currently in progress.
+- **Completed**: Tasks that are done.
+
+## Project properties
+
+
+
+Quickly view and edit project properties in the info icon tab on the side panel.
+
+- **State**: Displays the current state of the project (e.g., Execution).
+- **Priority**: Shows the priority level (e.g., Urgent, High, Medium, Low, or None).
+- **Team composition**: See the number of **Members** involved and the assigned Project **Lead**.
+- **Timeline**: Manage and monitor **Start date** and **Due date** for the project.
+
+## Project Updates
+Share project status using updates. This helps keep your team informed and create a timeline of project progress.
+
+### Enable project updates
+
+Go to your [project's settings](/core-concepts/projects/overview#project-settings) and turn on **Project Updates**.
+
+
+
+### Add project updates
+
+1. Select the tab with rocket icon in the side panel.
+2. Click the **Add an Update** button.
+2. Select the status. Each update can be marked as:
+ - 🚀 **On Track** - Project is progressing as planned
+ - ⚠️ **At Risk** - There are potential issues that need attention
+ - âť— **Off Track** - Project has significant blockers or delays
+3. Add your update message.
+4. Click **Add update**.
+
+
+
+### Collaborate on updates
+
+- Start threaded discussions around specific updates or tasks.
+- Use emoji reactions for quick feedback.
+- Mention team members to notify them directly. (coming soon)
+
+## Activity feed
+
+Get real-time updates on project activities, such as task progress, state changes, and new assignments. Updates are listed chronologically, making it easy to follow the project’s history.
+
+
diff --git a/docs/core-concepts/projects/project-states.mdx b/docs/core-concepts/projects/project-states.mdx
index e9aa949..9e3d6a4 100644
--- a/docs/core-concepts/projects/project-states.mdx
+++ b/docs/core-concepts/projects/project-states.mdx
@@ -1,12 +1,12 @@
---
-title: State Of Projects
+title: Project states
hide_title: true
---
import Tags from '@site/src/components/Tags';
-# Manage project progress with states
+# Manage projects with states