Add missing category frontmatter to 42 Copilot documentation files (#59419)

Copilot · subatoi · am-stead · web-flow · commit d80860d73d0f · 2026-02-02T17:04:52.000Z
Co-authored-by: copilot-swe-agent[bot] &lt;198982749+Copilot@users.noreply.github.com&gt;
Co-authored-by: subatoi &lt;32935794+subatoi@users.noreply.github.com&gt;
Co-authored-by: Anne-Marie &lt;102995847+am-stead@users.noreply.github.com&gt;
diff --git a/content/copilot/concepts/about-enterprise-accounts-for-copilot-business.md b/content/copilot/concepts/about-enterprise-accounts-for-copilot-business.md
@@ -14,6 +14,8 @@ redirect_from:
   - /early-access/copilot/managing-copilot-business-licenses-with-an-enterprise-account
   - /early-access/copilot/managing-copilot-business-licenses-with-an-enterprise-account
 contentType: concepts
+category:
+  - Learn about Copilot
 ---
 
 ## How can my enterprise use {% data variables.product.prodname_copilot %} only?
diff --git a/content/copilot/concepts/agents/about-agent-skills.md b/content/copilot/concepts/agents/about-agent-skills.md
@@ -7,6 +7,8 @@ versions:
   feature: copilot
 topics:
   - Copilot
+category:
+  - Learn about Copilot
 ---
 
 ## About Agent Skills
diff --git a/content/copilot/concepts/agents/coding-agent/about-custom-agents.md b/content/copilot/concepts/agents/coding-agent/about-custom-agents.md
@@ -7,6 +7,8 @@ versions:
   feature: copilot
 topics:
   - Copilot
+category:
+  - Learn about Copilot
 ---
 
 ## About {% data variables.copilot.custom_agents_short %}
diff --git a/content/copilot/concepts/agents/coding-agent/agent-management.md b/content/copilot/concepts/agents/coding-agent/agent-management.md
@@ -10,6 +10,9 @@ topics:
 redirect_from:
   - /copilot/concepts/agents/coding-agent/managing-agents
 contentType: concepts
+category:
+  - Learn about Copilot
+  - Author and optimize with Copilot
 ---
 
 ## About agents
diff --git a/content/copilot/concepts/agents/enterprise-management.md b/content/copilot/concepts/agents/enterprise-management.md
@@ -7,6 +7,8 @@ versions:
 topics:
   - Copilot
 contentType: concepts
+category:
+  - Learn about Copilot
 ---
 
 {% data reusables.enterprise-accounts.ai-controls-preview-note %}
diff --git a/content/copilot/concepts/agents/openai-codex.md b/content/copilot/concepts/agents/openai-codex.md
@@ -9,6 +9,8 @@ versions:
 topics:
   - Copilot
 contentType: concepts
+category:
+  - Learn about Copilot
 ---
 
 > [!NOTE] {% data variables.product.prodname_openai_codex %} integration is currently in {% data variables.release-phases.public_preview %}.
diff --git a/content/copilot/concepts/copilot-metrics.md b/content/copilot/concepts/copilot-metrics.md
@@ -15,6 +15,9 @@ redirect_from:
   - /early-access/copilot-metrics/apis/about-the-copilot-metrics-apis
   - /early-access/copilot-metrics/dashboards/about-the-copilot-metrics-dashboard
   - /early-access/copilot-metrics/apis/rest-api-endpoints-for-copilot-enterprise-and-user-usage-metrics
+category:
+  - Learn about Copilot
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/concepts/mcp-management.md b/content/copilot/concepts/mcp-management.md
@@ -7,6 +7,9 @@ versions:
 topics:
   - Copilot
 contentType: concepts
+category:
+  - Learn about Copilot
+  - Manage Copilot for a team
 ---
 
 You can manage Model Context Protocol (MCP) server usage in your organization or enterprise by configuring a series of MCP policies on {% data variables.product.prodname_dotcom_the_website %}. Through these policies, you can allow or block MCP server usage entirely, or restrict access to a list of servers that you define in an MCP registry.
diff --git a/content/copilot/concepts/tools/about-copilot-integrations.md b/content/copilot/concepts/tools/about-copilot-integrations.md
@@ -8,6 +8,9 @@ topics:
   - Copilot  
 product: '{% data reusables.gated-features.copilot-integrations %}<br><a href="https://github.com/features/copilot/plans?ref_product=copilot&ref_type=engagement&ref_style=button" target="_blank" class="btn btn-primary mt-3 mr-3 no-underline"><span>Sign up for {% data variables.product.prodname_copilot_short %}</span> {% octicon "link-external" height:16 %}</a>'
 contentType: concepts
+category:
+  - Learn about Copilot
+  - Integrate Copilot with your tools
 ---
 
 ## Overview
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/monitor-agentic-activity.md
@@ -8,6 +8,8 @@ topics:
   - Copilot
 shortTitle: Monitor agentic activity
 contentType: how-tos
+category:
+  - Manage Copilot for a team
 ---
 
 {% data reusables.enterprise-accounts.ai-controls-preview-note %}
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents.md
@@ -8,6 +8,9 @@ topics:
   - Copilot
 shortTitle: Prepare for custom agents
 contentType: how-tos
+category:
+  - Configure Copilot
+  - Manage Copilot for a team
 ---
 
 {% data reusables.enterprise-accounts.ai-controls-preview-note %}
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/use-your-own-api-keys.md
@@ -8,6 +8,9 @@ topics:
   - Copilot
 contentType: how-tos
 allowTitleToDifferFromFilename: true
+category:
+  - Configure Copilot
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.byok-intro %}
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-code-generation.md
@@ -9,6 +9,8 @@ topics:
   - Copilot
 contentType: how-tos
 allowTitleToDifferFromFilename: true
+category:
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption.md b/content/copilot/how-tos/administer-copilot/manage-for-enterprise/view-usage-and-adoption.md
@@ -9,6 +9,8 @@ topics:
   - Copilot
 contentType: how-tos
 allowTitleToDifferFromFilename: true
+category:
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents.md b/content/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents.md
@@ -8,6 +8,9 @@ topics:
   - Copilot
 shortTitle: Prepare for custom agents
 contentType: how-tos
+category:
+  - Configure Copilot
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.custom-agents-preview-note %}
diff --git a/content/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys.md b/content/copilot/how-tos/administer-copilot/manage-for-organization/use-your-own-api-keys.md
@@ -8,6 +8,9 @@ topics:
   - Copilot
 contentType: how-tos
 allowTitleToDifferFromFilename: true
+category:
+  - Configure Copilot
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.byok-intro %}
diff --git a/content/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-mcp-registry.md b/content/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-mcp-registry.md
@@ -10,6 +10,9 @@ topics:
   - Enterprise
 shortTitle: Configure MCP registry
 contentType: how-tos
+category:
+  - Configure Copilot
+  - Manage Copilot for a team
 ---
 
 ## Prerequisites
diff --git a/content/copilot/how-tos/provide-context/use-mcp/change-mcp-registry.md b/content/copilot/how-tos/provide-context/use-mcp/change-mcp-registry.md
@@ -7,6 +7,8 @@ versions:
   feature: copilot
 defaultTool: jetbrains
 contentType: how-tos
+category:
+  - Configure Copilot
 ---
 
 MCP registries for {% data variables.product.prodname_copilot_short %} in your IDE streamline the process of discovering and setting up MCP servers. By default, {% data variables.product.prodname_copilot_short %} uses the {% data variables.product.github %} MCP Registry, but you can configure your own MCP registry to customize the list of servers available in your environment.
diff --git a/content/copilot/how-tos/provide-context/use-mcp/configure-toolsets.md b/content/copilot/how-tos/provide-context/use-mcp/configure-toolsets.md
@@ -10,6 +10,8 @@ topics:
 redirect_from:
   - /copilot/how-tos/context/use-mcp/configure-toolsets
 contentType: how-tos
+category:
+  - Configure Copilot
 ---
 
 The {% data variables.product.github %} MCP server includes default toolsets (`repos`, `issues`, and `pull_requests`) that are enabled automatically. You can customize toolset configuration by:
diff --git a/content/copilot/how-tos/provide-context/use-mcp/enterprise-configuration.md b/content/copilot/how-tos/provide-context/use-mcp/enterprise-configuration.md
@@ -8,6 +8,8 @@ defaultTool: vscode
 topics:
   - Copilot
 contentType: how-tos
+category:
+  - Configure Copilot
 ---
 
 The {% data variables.product.github %} MCP server can be configured to work with {% data variables.product.prodname_ghe_server %} and {% data variables.enterprise.data_residency %}. The configuration steps differ depending on whether you are using the remote or local MCP server.
diff --git a/content/copilot/how-tos/set-up/set-up-a-dedicated-enterprise-for-copilot-business.md b/content/copilot/how-tos/set-up/set-up-a-dedicated-enterprise-for-copilot-business.md
@@ -15,6 +15,9 @@ topics:
   - Accounts
   - Copilot
 shortTitle: Set up a dedicated enterprise
+category:
+  - Configure Copilot
+  - Manage Copilot for a team
 ---
 
 You can create an enterprise account specifically for managing {% data variables.copilot.copilot_business_short %} licenses, without adopting {% data variables.product.prodname_enterprise %}. With this account, you will have access to enterprise-grade integrations with identity providers for authentication and provisioning, without needing to pay for {% data variables.product.prodname_enterprise %} licenses. See [AUTOTITLE](/copilot/concepts/about-enterprise-accounts-for-copilot-business).
diff --git a/content/copilot/how-tos/troubleshoot-copilot/troubleshoot-common-issues.md b/content/copilot/how-tos/troubleshoot-copilot/troubleshoot-common-issues.md
@@ -15,6 +15,8 @@ redirect_from:
   - /copilot/how-tos/troubleshoot/troubleshooting-common-issues-with-github-copilot
   - /copilot/how-tos/troubleshoot/troubleshoot-common-issues
 contentType: how-tos
+category:
+  - Troubleshooting Copilot
 ---
 
 
diff --git a/content/copilot/how-tos/troubleshoot-copilot/troubleshoot-firewall-settings.md b/content/copilot/how-tos/troubleshoot-copilot/troubleshoot-firewall-settings.md
@@ -13,6 +13,8 @@ redirect_from:
   - /copilot/how-tos/troubleshoot/troubleshooting-firewall-settings-for-github-copilot
   - /copilot/how-tos/troubleshoot/troubleshoot-firewall-settings
 contentType: how-tos
+category:
+  - Troubleshooting Copilot
 ---
 
 ## About the problem
diff --git a/content/copilot/how-tos/troubleshoot-copilot/troubleshoot-network-errors.md b/content/copilot/how-tos/troubleshoot-copilot/troubleshoot-network-errors.md
@@ -14,6 +14,8 @@ versions:
   feature: copilot
 shortTitle: Troubleshoot network errors
 contentType: how-tos
+category:
+  - Troubleshooting Copilot
 ---
 
 If you're working on company equipment and connecting to a corporate network, you may be connecting to the Internet via a VPN or an HTTP proxy server. In some cases, these types of network setups may prevent {% data variables.product.prodname_copilot %} from connecting to {% data variables.product.prodname_dotcom %}'s server. For more information about the options for setting up proxies with {% data variables.product.prodname_copilot %}, see [AUTOTITLE](/copilot/configuring-github-copilot/configuring-network-settings-for-github-copilot).
diff --git a/content/copilot/how-tos/troubleshoot-copilot/troubleshoot-spark.md b/content/copilot/how-tos/troubleshoot-copilot/troubleshoot-spark.md
@@ -7,6 +7,8 @@ topics:
   - Copilot
 shortTitle: Troubleshoot Spark
 contentType: how-tos
+category:
+  - Troubleshooting Copilot
 ---
 
 ## Error: "Live preview is interrupted. Try refreshing the page to reconnect."
diff --git a/content/copilot/how-tos/troubleshoot-copilot/view-logs.md b/content/copilot/how-tos/troubleshoot-copilot/view-logs.md
@@ -18,6 +18,8 @@ versions:
   feature: copilot
 shortTitle: View logs
 contentType: how-tos
+category:
+  - Troubleshooting Copilot
 ---
 
 {% jetbrains %}
diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents.md
@@ -7,6 +7,9 @@ versions:
   feature: copilot
 topics:
   - Copilot
+category:
+  - Configure Copilot
+  - Author and optimize with Copilot
 ---
 
 {% data variables.copilot.custom_agents_caps_short %} allow you to create specialized agents with tailored expertise for specific tasks. For a conceptual overview of {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/concepts/agents/coding-agent/about-custom-agents).
diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-linear.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-linear.md
@@ -7,6 +7,8 @@ versions:
 topics:
   - Copilot
 contentType: how-tos
+category:
+  - Integrate Copilot with your tools
 ---
 
 > [!NOTE]
diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-slack.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/integrate-coding-agent-with-slack.md
@@ -5,6 +5,8 @@ intro: 'Provide context to the {% data variables.product.prodname_copilot_short
 versions:
   feature: copilot
 contentType: how-tos
+category:
+  - Integrate Copilot with your tools
 ---
 
 > [!NOTE]
diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/make-changes-to-an-existing-pr.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/make-changes-to-an-existing-pr.md
@@ -9,6 +9,8 @@ versions:
 topics:
   - Copilot
 contentType: how-tos
+category:
+  - Author and optimize with Copilot
 ---
 
 > [!NOTE]
diff --git a/content/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents.md b/content/copilot/how-tos/use-copilot-agents/coding-agent/test-custom-agents.md
@@ -7,6 +7,9 @@ topics:
   - Copilot
 shortTitle: Test custom agents
 contentType: how-tos
+category:
+  - Configure Copilot
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.custom-agents-preview-note %}
diff --git a/content/copilot/how-tos/use-copilot-agents/manage-agents.md b/content/copilot/how-tos/use-copilot-agents/manage-agents.md
@@ -8,6 +8,8 @@ versions:
 topics:
   - Copilot
 contentType: how-tos
+category:
+  - Author and optimize with Copilot
 ---
 
 {% data reusables.copilot.coding-agent.agent-management-intro %}
diff --git a/content/copilot/reference/agentic-audit-log-events.md b/content/copilot/reference/agentic-audit-log-events.md
@@ -8,6 +8,8 @@ versions:
 topics:
   - Copilot
 contentType: reference
+category:
+  - Learn about Copilot
 ---
 
 You can apply the `actor:Copilot` filter to your enterprise audit log to view agentic activity over the last 180 days. The following key fields can help you interpret agentic events:
diff --git a/content/copilot/reference/copilot-feature-matrix.md b/content/copilot/reference/copilot-feature-matrix.md
@@ -5,6 +5,8 @@ versions:
   feature: copilot
 topics:
   - Copilot
+category:
+  - Learn about Copilot
 ---
 
 > [!NOTE]
diff --git a/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md b/content/copilot/reference/copilot-usage-metrics/copilot-usage-metrics.md
@@ -11,6 +11,8 @@ type: reference
 topics:
   - Copilot
   - Enterprise
+category:
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/reference/copilot-usage-metrics/interpret-copilot-metrics.md b/content/copilot/reference/copilot-usage-metrics/interpret-copilot-metrics.md
@@ -12,6 +12,8 @@ allowTitleToDifferFromFilename: true
 redirect_from:
   - /early-access/copilot-metrics/dashboards/interpreting-the-metrics
   - /copilot/reference/interpret-copilot-metrics
+category:
+  - Manage Copilot for a team
 ---
 
 >[!NOTE] The {% data variables.product.prodname_copilot_short %} usage metrics dashboard is currently in {% data variables.release-phases.public_preview %} and subject to change.
diff --git a/content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md b/content/copilot/reference/copilot-usage-metrics/lines-of-code-metrics.md
@@ -12,6 +12,8 @@ topics:
   - Copilot
 contentType: reference
 allowTitleToDifferFromFilename: true
+category:
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics.md b/content/copilot/reference/copilot-usage-metrics/reconciling-usage-metrics.md
@@ -12,6 +12,8 @@ allowTitleToDifferFromFilename: true
 redirect_from:
   - /early-access/copilot-metrics/dashboards/best-practices-for-correlating-usage-metrics
   - /copilot/reference/reconciling-usage-metrics
+category:
+  - Manage Copilot for a team
 ---
 
 {% data reusables.copilot.usage-metrics-preview %}
diff --git a/content/copilot/reference/custom-agents-configuration.md b/content/copilot/reference/custom-agents-configuration.md
@@ -7,6 +7,8 @@ versions:
 topics:
   - Copilot
 contentType: reference
+category:
+  - Configure Copilot
 ---
 
 This reference article provides detailed configuration information for {% data variables.copilot.custom_agents_short %}. For general information about creating {% data variables.copilot.custom_agents_short %}, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents).
diff --git a/content/copilot/reference/custom-instructions-support.md b/content/copilot/reference/custom-instructions-support.md
@@ -7,6 +7,8 @@ versions:
 topics:
   - Copilot
 contentType: reference
+category:
+  - Learn about Copilot
 ---
 
 This reference article provides details of which types of custom instructions are supported in various environments. For more information about the various types of custom instructions for {% data variables.product.prodname_copilot %}, see [AUTOTITLE](/copilot/concepts/prompting/response-customization).
diff --git a/content/copilot/reference/hooks-configuration.md b/content/copilot/reference/hooks-configuration.md
@@ -7,6 +7,8 @@ versions:
 topics:
   - Copilot
 contentType: reference
+category:
+  - Configure Copilot
 ---
 
 This reference article describes the available hook types with examples, including their input and output formats, script best practices, and advanced patterns for logging, security enforcement, and external integrations. For general information about creating hooks, see [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/use-hooks).
diff --git a/content/copilot/reference/mcp-allowlist-enforcement.md b/content/copilot/reference/mcp-allowlist-enforcement.md
@@ -6,6 +6,8 @@ versions:
 topics:
   - Copilot
 contentType: reference
+category:
+  - Learn about Copilot
 ---
 
 ## Current enforcement limitations
