[2026-02-20] Introduce organization-level Copilot metrics dashboard [public preview] (#59447)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Melanie Yarbrough <11952755+myarb@users.noreply.github.com>
Co-authored-by: Joe Clark <31087804+jc-clark@users.noreply.github.com>

Author: 4 people

content/copilot/concepts/copilot-usage-metrics/copilot-metrics.md

@@ -33,21 +33,10 @@ category:
 Metrics are available through:
 
 * The {% data variables.product.prodname_copilot_short %} usage metrics APIs, which provide detailed, exportable data at the enterprise, organization, and user levels.
-* The {% data variables.product.prodname_copilot_short %} usage metrics dashboard, which visualizes 28-day usage trends across your enterprise.
-* The code generation dashboard, which breaks down how code is being generated by users and agents across your enterprise.
+* The {% data variables.product.prodname_copilot_short %} usage metrics dashboard, which visualizes 28-day usage trends across your enterprise and organizations.
+* The code generation dashboard, which breaks down how code is being generated by users and agents across your enterprise and organizations.
 * The {% data variables.product.prodname_copilot_short %} usage metrics NDJSON export, which offers raw data for custom BI tools or long-term storage.
 
-### Organization-level metrics
-
-Organization-level metrics are **only available through the APIs**. Both dashboards provide enterprise-level reporting.
-
-To access organization-level metrics, the "{% data variables.product.prodname_copilot_short %} usage metrics" policy must be enabled for the enterprise or organization:
-
-* For information on how to enable the "{% data variables.product.prodname_copilot_short %} usage metrics" policy at the enterprise level, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies#defining-policies-for-your-enterprise).
-* For information on how to enable the "{% data variables.product.prodname_copilot_short %} usage metrics" policy for organizations on a {% data variables.product.prodname_free_team %} or {% data variables.product.prodname_team %} plan that do not belong to an enterprise, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-organization/manage-policies#enabling-copilot-features-and-models-in-your-organization).
-
-For a complete list of available metrics and data fields, see [AUTOTITLE](/copilot/reference/copilot-usage-metrics).
-
 ## Which usage is included?
 
 The {% data variables.product.prodname_copilot_short %} usage metrics are derived exclusively from telemetry sent by IDEs. In order for an end user to be counted towards these metrics, they **must have telemetry enabled in their IDE**.
@@ -70,7 +59,7 @@ The following API resources expose {% data variables.product.prodname_copilot_sh
 
 | API resource | Scope | Key capabilities |
 | --- | --- | --- |
-| [AUTOTITLE](/rest/copilot/copilot-usage-metrics) | Advanced enterprise- and user-level event telemetry | Provides unified telemetry across completions, chat, and agent modes. Includes usage and lines of code metrics across all IDE modes, languages, and models. Supports detailed breakdowns by feature, IDE, language, model, and user, and is the primary API resource being actively developed and maintained. |
+| [AUTOTITLE](/rest/copilot/copilot-usage-metrics) | Advanced enterprise-, organization-, and user-level event telemetry | Provides unified telemetry across completions, chat, and agent modes. Includes usage and lines of code metrics across all IDE modes, languages, and models. Supports detailed breakdowns by feature, IDE, language, model, and user, and is the primary API resource being actively developed and maintained. |
 | [AUTOTITLE](/rest/copilot/copilot-user-management) | License and seat assignment | Lists assigned {% data variables.product.prodname_copilot_short %} seats for an organization or enterprise, including license state, user association, and `last_activity_at`. This API resource is the source of truth for license and seat information. |
 | [AUTOTITLE](/rest/copilot/copilot-metrics) | Enterprise-, organization-, and team-level usage metrics | Provides aggregated usage data for {% data variables.product.prodname_copilot_short %} features on {% data variables.product.prodname_dotcom_the_website %} (such as pull request summaries) and some IDE-based completions and chat. Does not include Agent or Edit mode telemetry. Offers enterprise-wide and per-feature breakdowns by IDE and language. Does not include individual-level data. |
 
@@ -118,7 +107,7 @@ For example, all usage data for a Monday (which closes at midnight UTC) will be
 
 {% data variables.product.prodname_copilot_short %} usage metrics can be grouped into a few main categories: Adoption, engagement, acceptance rate, Lines of Code (LoC), and pull request lifecycle metrics.
 
-**Adoption** measures how many licensed developers are actively using {% data variables.product.prodname_copilot_short %} within your enterprise. For example, daily active users (DAU) tells you how many unique users interacted with {% data variables.product.prodname_copilot_short %} on a given day. Ideally, you'll see a consistent upward trend in these metrics during rollout.
+**Adoption** measures how many licensed developers are actively using {% data variables.product.prodname_copilot_short %}. For example, daily active users (DAU) tells you how many unique users interacted with {% data variables.product.prodname_copilot_short %} on a given day. Ideally, you'll see a consistent upward trend in these metrics during rollout.
 
 **Engagement** measures describe how deeply developers use {% data variables.product.prodname_copilot_short %} once they’ve adopted it. Key engagement metrics show not only frequency of use but also breadth across features. For example, average chat requests per active user measures how often users open and interact with {% data variables.copilot.copilot_chat_short %}. You'd want to see regular and increasing chat use across languages and IDEs.
 
@@ -146,6 +135,6 @@ Look for patterns across these signals rather than focusing on any single number
 
 Now that you understand what each {% data variables.product.prodname_copilot_short %} metric measures and how to use them, you can explore the dashboards to see these metrics in action.
 
-* To view adoption and usage trends across your enterprise, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption).
+* To view adoption and usage trends across your enterprise and organizations, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption).
 * To analyze how code is being generated by users and agents, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation).
-* To access enterprise-, organization-, and user-level metrics programmatically, see [AUTOTITLE](/rest/copilot/copilot-usage-metrics).
+* To access {% data variables.product.prodname_copilot_short %} usage metrics programmatically, see [AUTOTITLE](/rest/copilot/copilot-usage-metrics).

content/copilot/concepts/copilot-usage-metrics/index.md

@@ -13,8 +13,8 @@ sidebarLink:
   href: /copilot/concepts/copilot-usage-metrics
 children:
   - /copilot-metrics
-  - /content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption
-  - /content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation
+  - /content/copilot/how-tos/administer-copilot/view-usage-and-adoption
+  - /content/copilot/how-tos/administer-copilot/view-code-generation
   - /content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics
   - /content/copilot/reference/copilot-usage-metrics/interpret-copilot-metrics
   - /content/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics

content/copilot/how-tos/administer-copilot/index.md

@@ -1,7 +1,7 @@
 ---
 title: Administer GitHub Copilot for your team
 shortTitle: Administer Copilot
-intro: 'Learn how to administer {% data variables.product.prodname_copilot %} for your organization or enterprise.'
+intro: Manage {% data variables.product.prodname_copilot %} for your team by configuring settings, monitoring usage, and accessing activity reports to optimize adoption.
 versions:
   feature: copilot
 topics:
@@ -11,6 +11,8 @@ children:
   - /manage-for-enterprise
   - /manage-mcp-usage
   - /download-activity-report
+  - /view-usage-and-adoption
+  - /view-code-generation
 redirect_from:
   - /copilot/how-tos/administer
 contentType: how-tos

content/copilot/how-tos/administer-copilot/manage-for-enterprise/index.md

@@ -1,7 +1,7 @@
 ---
 title: Managing GitHub Copilot in your enterprise
 shortTitle: Manage for enterprise
-intro: 'Enterprise owners can subscribe to {% data variables.product.prodname_copilot_short %}, manage {% data variables.product.prodname_copilot_short %} for organizations in the enterprise, and control {% data variables.product.prodname_copilot_short %} policies.'
+intro: Manage and govern {% data variables.product.prodname_copilot %} across your enterprise by controlling licensing and access, setting policies and guardrails, and monitoring adoption and usage.
 versions:
   feature: copilot
 topics:
@@ -12,8 +12,6 @@ children:
   - /manage-enterprise-policies
   - /manage-agents
   - /manage-spark
-  - /view-usage-and-adoption
-  - /view-code-generation
   - /use-your-own-api-keys
 redirect_from:
   - /copilot/managing-copilot/managing-copilot-for-your-enterprise

content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation.md

@@ -0,0 +1,44 @@
+---
+title: Viewing the code generation dashboard
+shortTitle: View code generation
+intro: The code generation dashboard shows how {% data variables.product.prodname_copilot_short %} generates code across your enterprise, including activity from both users and agents.
+permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
+versions:
+  feature: copilot
+topics:
+  - Copilot
+contentType: how-tos
+allowTitleToDifferFromFilename: true
+redirect_from:
+  - /copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation
+category:
+  - Copilot usage metrics
+  - View metrics
+  - Track Copilot usage
+---
+
+{% data reusables.copilot.usage-metrics-preview %}
+
+By comparing user-initiated and agent-initiated activity across models, languages, and modes, you can see how teams are adopting AI-assisted and agent-driven development.
+
+The dashboard shows aggregated code generation activity, including:
+
+* **Lines of code changed with AI**. The total lines of code added and deleted across all modes.
+* **User-initiated code changes**. Lines suggested or manually added through completions and chat actions.
+* **Agent-initiated code changes**. Lines automatically added or deleted by agents across edit, agent, and custom modes.
+* **Activity by model and language**. User-initiated and agent-initiated activity grouped by model and language.
+
+For a detailed list of available metrics and definitions, see [AUTOTITLE](/copilot/reference/copilot-usage-metrics/copilot-usage-metrics#code-generation-dashboard-metrics).
+
+## Prerequisite
+
+{% data reusables.copilot.copilot-metrics-dashboard-prereq %}
+
+## Accessing the dashboard
+
+{% data reusables.copilot.access-copilot-metrics-dashboard %}
+1. In the left sidebar, click **Code generation**.
+
+## Next steps
+
+To learn how to interpret the data in each chart and act on usage trends, see [AUTOTITLE](/copilot/reference/interpret-copilot-metrics).

content/copilot/how-tos/administer-copilot/view-code-generation.md

@@ -1,14 +1,16 @@
 ---
 title: Viewing the Copilot usage metrics dashboard
 shortTitle: View usage and adoption
-intro: '{% data variables.product.prodname_copilot_short %} usage metrics dashboards provide a centralized view of adoption and usage across your enterprise, based on IDE telemetry from developers using {% data variables.product.prodname_copilot_short %}.'
+intro: 'Monitor adoption trends and use of {% data variables.product.prodname_copilot_short %} to support long-term enablement.'
 permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
 topics:
   - Copilot
 contentType: how-tos
 allowTitleToDifferFromFilename: true
+redirect_from:
+  - /copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption
 category:
   - Copilot usage metrics
   - View metrics
@@ -21,14 +23,14 @@ After your initial rollout, the {% data variables.product.prodname_copilot_short
 
 ## Prerequisite
 
-"{% data variables.product.prodname_copilot_short %} usage metrics" must be enabled on the AI Control tab. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-enterprise-policies#defining-policies-for-your-enterprise).
+{% data reusables.copilot.copilot-metrics-dashboard-prereq %}
 
 ## Accessing the dashboard
 
 {% data reusables.copilot.access-copilot-metrics-dashboard %}
 1. In the left sidebar, click **{% data variables.product.prodname_copilot_short %} usage**.
 
-Data in the dashboard reports data at the enterprise level, is based only on IDE telemetry, and may appear up to three full UTC days behind the current date. See [AUTOTITLE](/copilot/concepts/copilot-metrics).
+Data in the dashboard is based only on IDE telemetry, and may appear up to three full UTC days behind the current date. See [AUTOTITLE](/copilot/concepts/copilot-metrics).
 
 ## Using {% data variables.copilot.copilot_chat_short %} to analyze exported data
 

…or-enterprise/view-usage-and-adoption.md …ister-copilot/view-usage-and-adoption.mdcontent/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption.md renamed to content/copilot/how-tos/administer-copilot/view-usage-and-adoption.md content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption.md renamed to content/copilot/how-tos/administer-copilot/view-usage-and-adoption.md

@@ -21,8 +21,8 @@ category:
 
 The {% data variables.product.prodname_copilot_short %} usage metrics dashboard and APIs display and export data using a consistent set of fields. This reference lists all available metrics and describes how to interpret their values in both dashboard visuals and NDJSON or API exports.
 
-* The {% data variables.product.prodname_copilot_short %} usage metrics dashboard reports data at the **enterprise** level. To access the dashboard, see [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption).
-* The {% data variables.product.prodname_copilot_short %} usage metrics APIs support **enterprise-, organization-, and user-level** records. To retrieve this data programmatically, see [AUTOTITLE](/rest/copilot/copilot-usage-metrics).
+* The {% data variables.product.prodname_copilot_short %} usage metrics dashboards are available at the **enterprise** and **organization** level.
+* The {% data variables.product.prodname_copilot_short %} usage metrics APIs support **enterprise-, organization-, and user-level** records.
 
 For guidance on how to read and interpret these metrics, see [AUTOTITLE](/copilot/concepts/copilot-metrics).
 

content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md

@@ -18,15 +18,13 @@ category:
   - Track Copilot usage
 ---
 
->[!NOTE] The {% data variables.product.prodname_copilot_short %} usage metrics dashboard is currently in {% data variables.release-phases.public_preview %} and subject to change.
+{% data reusables.copilot.usage-metrics-preview %}
 
 After you’ve viewed the {% data variables.product.prodname_copilot_short %} usage metrics dashboard, you can use this article to interpret each chart and identify opportunities to increase adoption and engagement.
 
-> [!NOTE] The dashboard reports enterprise-level data. Organization-level views are available through the {% data variables.product.prodname_copilot_short %} usage metrics APIs.
-
 ## Reviewing overall usage trends
 
-Use the main usage charts in the dashboard to understand overall adoption and engagement patterns across your enterprise. These charts help you identify where usage is growing, leveling off, or declining, so you can take action to maintain engagement.
+Use the main usage charts in the dashboard to understand overall adoption and engagement patterns. These charts help you identify where usage is growing, leveling off, or declining, so you can take action to maintain engagement.
 
 | Metric | What it shows | How to interpret it |
 |:--|:--|:--|
@@ -45,11 +43,11 @@ The "Requests per chat mode" and "Agent adoption" charts show how developers are
 
 ## Reviewing model adoption
 
-The "Model usage per day" and "Model usage per chat mode" charts help you understand which AI models are most frequently used in your enterprise.
+The "Model usage per day" and "Model usage per chat mode" charts help you understand which AI models are most frequently used.
 
 | Chart | Description | Insights to derive |
 |:--|:--|:--|
-| Model usage per day | Shows which AI models power {% data variables.copilot.copilot_chat_short %} activity across the enterprise. | Identify whether users are primarily engaging with default models or experimenting with newer ones. |
+| Model usage per day | Shows which AI models power {% data variables.copilot.copilot_chat_short %} activity. | Identify whether users are primarily engaging with default models or experimenting with newer ones. |
 | Model usage per chat mode | Breaks down model usage by chat mode (Ask, Edit, Agent). | Monitor how model adoption evolves as new models are released. |
 
 > [!NOTE]

content/copilot/reference/copilot-usage-metrics/interpret-copilot-metrics.md

@@ -26,7 +26,7 @@ Lines of Code (LoC) metrics provide a directional measure of {% data variables.p
 
 You may encounter LoC metrics in:
 
-* **Code generation dashboard (enterprise level)** — visualizes LoC-based user and agent activity. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation).
+* **Code generation dashboard (enterprise and organization level)** — visualizes LoC-based user and agent activity. See [AUTOTITLE](/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation).
 * **Exports and APIs (enterprise, organization, and user level)** — expose LoC fields such as `loc_suggested_to_add_sum`, `loc_added_sum`, and `loc_deleted_sum`. See [AUTOTITLE](/rest/copilot/copilot-usage-metrics).
 * **"Data available in {% data variables.product.prodname_copilot_short %} usage metrics" reference** — lists all dashboard and API fields derived from LoC. See [AUTOTITLE](/copilot/reference/copilot-usage-metrics/copilot-usage-metrics).