[2025-11-13] Fine Grain Permissions for Copilot Metrics [public preview] (#58378)

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: sophietheking

content/copilot/concepts/copilot-metrics.md

@@ -19,7 +19,7 @@ redirect_from:
 
 {% data reusables.copilot.usage-metrics-preview %}
 
-{% data variables.product.prodname_copilot_short %} usage metrics help enterprise administrators and decision-makers understand how their teams are adopting and using {% data variables.product.prodname_copilot_short %}. By tracking usage patterns across the enterprise, you can measure engagement, identify opportunities to increase value, and make data-driven decisions about enablement and rollout.
+{% data variables.product.prodname_copilot_short %} usage metrics help key stakeholders and decision-makers understand how their teams are adopting and using {% data variables.product.prodname_copilot_short %}. By tracking usage patterns across the enterprise, you can measure engagement, identify opportunities to increase value, and make data-driven decisions about enablement and rollout.
 
 Metrics are available through:
 

content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption.md

@@ -2,7 +2,7 @@
 title: Viewing the Copilot usage metrics dashboard
 shortTitle: View usage and adoption
 intro: You can use the {% data variables.product.prodname_copilot_short %} usage metrics dashboard to monitor adoption and usage trends across your enterprise.
-permissions: Enterprise owners and billing managers
+permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
 topics:

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

@@ -3,7 +3,7 @@ title: Data available in Copilot usage metrics
 allowTitleToDifferFromFilename: true
 shortTitle: Copilot usage metrics data
 intro: 'You can display and export {% data variables.product.prodname_copilot_short %} usage metrics data in the dashboard and via APIs.'
-permissions: Enterprise owners and billing managers
+permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   fpt: '*'
   ghec: '*'

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

@@ -2,7 +2,7 @@
 title: Interpreting usage and adoption metrics for GitHub Copilot
 shortTitle: Interpret usage metrics
 intro: 'Evaluate trends surfaced in {% data variables.product.prodname_copilot_short %} usage metrics to enable adoption in your enterprise.'
-permissions: Enterprise owners and billing managers
+permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
 topics:

content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md

@@ -2,7 +2,7 @@
 title: Lines of Code metrics
 shortTitle: Copilot LoC metrics
 intro: Understand how Lines of Code metrics measure {% data variables.product.prodname_copilot_short %}’s output and what factors affect their coverage and accuracy.
-permissions: Enterprise owners and billing managers
+permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
 redirect_from:
@@ -16,7 +16,7 @@ allowTitleToDifferFromFilename: true
 
 {% data reusables.copilot.usage-metrics-preview %}
 
-Lines of Code (LoC) metrics offer a directional way to measure {% data variables.product.prodname_copilot_short %}’s tangible output. These metrics quantify how many lines {% data variables.product.prodname_copilot_short %} suggested, added, or deleted in the editor—helping enterprise administrators understand {% data variables.product.prodname_copilot_short %}’s contribution to the codebase over time.
+Lines of Code (LoC) metrics offer a directional way to measure {% data variables.product.prodname_copilot_short %}’s tangible output. These metrics quantify how many lines {% data variables.product.prodname_copilot_short %} suggested, added, or deleted in the editor—helping key stakeholders and decision makers understand {% data variables.product.prodname_copilot_short %}’s contribution to the codebase over time.
 
 LoC metrics may vary across IDEs and versions. Keep the following considerations in mind:
 

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

@@ -2,7 +2,7 @@
 title: Reconciling Copilot usage metrics across dashboards, APIs, and reports
 shortTitle: Reconciling Copilot usage metrics
 intro: Understand how {% data variables.product.prodname_copilot_short %} usage metrics differ between dashboards, APIs, and exported reports.
-permissions: Enterprise owners and billing managers
+permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
 topics:

content/copilot/tutorials/roll-out-at-scale/assign-licenses/track-usage-and-adoption.md

@@ -2,7 +2,7 @@
 title: Tracking license activation and initial usage with Copilot usage metrics
 shortTitle: Track usage and adoption
 intro: Identify and act on {% data variables.product.prodname_copilot %} adoption signals and activation with usage metrics.
-permissions: Enterprise owners and billing managers
+permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
 topics:

content/copilot/tutorials/roll-out-at-scale/establish-ai-managers.md

@@ -18,6 +18,7 @@ contentType: tutorials
 You can use custom roles and enterprise teams to delegate AI administration permissions without granting enterprise ownership. AI managers can view and manage **nearly all AI features in your enterprise's AI Controls**, including agentic AI features, {% data variables.product.prodname_copilot_short %} features, and Model Context Protocol (MCP) features.
 
 Unless you grant additional permissions beyond those listed in this article, AI managers **cannot access** the following:
+
 * Access management settings for {% data variables.product.prodname_copilot_short %}
 * Settings in the "Billing" section of the {% data variables.product.prodname_copilot_short %} page
 * Settings in the "Metrics" section of the {% data variables.product.prodname_copilot_short %} page
@@ -32,6 +33,7 @@ To get started, you need to create a custom role with the necessary permissions
 
     * **Manage enterprise AI controls**: Allows this role to view and manage all settings in the "AI Controls" tab for your enterprise
     * **Read enterprise audit logs**: Allows this role to view **all** audit log events for your enterprise, helping your AI managers monitor agentic activity
+    * **View Enterprise {% data variables.product.prodname_copilot_short %} Metrics**: Allows this role to view {% data variables.product.prodname_copilot_short %} usage metrics under the "Insights" tab
 
 1. Click **Create role**.
 

content/copilot/tutorials/roll-out-at-scale/measure-success.md

@@ -2,7 +2,7 @@
 title: Measuring the success of a GitHub Copilot trial
 shortTitle: Measure trial success
 intro: Learn how to use {% data variables.product.prodname_copilot_short %} usage metrics to evaluate your trial, interpret adoption and engagement results, and decide how to monitor usage going forward.
-permissions: Enterprise owners and billing managers
+permissions: '{% data reusables.copilot.usage-metrics-permissions %}'
 versions:
   feature: copilot
 type: tutorial

data/reusables/copilot/usage-metrics-permissions.md

@@ -0,0 +1 @@
+Enterprise owners, billing managers, and people with an enterprise custom role with the "View Enterprise {% data variables.product.prodname_copilot_short %} Metrics" permission