Clarify and consolidate documentation for content exclusions for the different GitHub Copilot modes

Open
#42,617 9 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
38/100
Issue type
Documentation
Clarity
Mostly clear
Activity status
Active
Tech stack
github
Domain
documentation

Research direction

Start by comparing the two GitHub Docs pages linked in the issue, then review related issue 40951 and closed pull request 40952 alongside the referenced VS Code discussions. Confirm the supported modes and environments with maintainers before consolidating the guidance into a support matrix; done means the documentation resolves the contradictions and states limitations clearly.

Written by the indexing model from the issue text.

Description

content copilot needs SME Waiting on SME review
Code of Conduct
What article on docs.github.com is affected?

https://docs.github.com/en/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot#configuring-content-exclusion-for-your-repository (accessed on 29th January 2026)
https://docs.github.com/en/copilot/concepts/context/content-exclusion#availability-of-content-exclusion (accessed on 29th January 2026)

What part(s) of the article would you like to see updated?

Problem Description

The current documentation around GitHub Copilot content exclusion appears to be inconsistent and, in some cases, contradictory across different official sources. This makes it difficult to understand which Copilot tools and modes actually respect content exclusion rules.

Conflicting Documentation

Configure content exclusion (GitHub Docs)

https://docs.github.com/en/copilot/how-tos/configure-content-exclusion/exclude-content-from-copilot#configuring-content-exclusion-for-your-repository

This page states that GitHub Copilot CLI, Copilot coding agent, and Agent mode in Copilot Chat in IDEs do not support content exclusion, and refers to additional documentation for clarification.

Content exclusion concepts and availability (GitHub Docs)

https://docs.github.com/en/copilot/concepts/context/content-exclusion#availability-of-content-exclusion

This page indicates that content exclusion is available in Copilot Chat for Visual Studio Code, but includes the following note:

  • Content exclusion is in public preview on the GitHub website and GitHub Mobile.
  • Content exclusion is currently not supported in Edit and Agent modes of Copilot Chat in Visual Studio Code and other editors.
Copilot Agent Mode (Microsoft Learn)

https://learn.microsoft.com/en-us/visualstudio/ide/copilot-agent-mode?view=visualstudio#frequently-asked-questions

This documentation states that Agent mode cannot access files and directories excluded through file exclusion, which suggests that content exclusion is respected by Agent mode, at least in Visual Studio.

Observed Behavior

When testing a simple scenario, content exclusion appeared to work across all Copilot modes, including those documented as unsupported. This may indicate:

  • Partial or implicit support depending on the tool or environment
  • Differences between file exclusion and content exclusion
  • Outdated or incomplete documentation

For the testing scenario we added an GitLab Repository for the content exclusion in the GitHub Copilot Business content exclusion setting and tested for the ask, edit and agent mode in the VS Code Chat if the file can be explained. For all the modes the response said that no context was attached even when i manually drag and dropped the file into the chat window.

Requested Improvement

The documentation should be updated to clearly and explicitly describe:

  • Which Copilot tools and modes support content exclusion
  • Which modes do not support it, and in what way
  • Whether behavior differs between:
    • Chat, Edit, and Agent modes
    • IDEs (VS Code, Visual Studio) and the GitHub website
  • Any known limitations, caveats, or indirect behaviors that may cause content exclusion to appear to work even when it is not fully supported

A concise support matrix or table outlining Copilot mode vs. content exclusion behavior would greatly improve clarity and help users avoid incorrect assumptions.

Clear and accurate documentation is particularly important for business and enterprise users, as content exclusion is often a critical compliance and data-protection requirement. Organizations need to clearly understand which Copilot modes and tools can be safely used while content exclusion is enabled, and which modes may bypass or partially ignore these rules. Without this clarity, there is a risk of unintentional exposure of sensitive or proprietary information and uncertainty about whether Copilot usage complies with internal policies and regulatory obligations.

Related Issues and Pull Requests
Additional information

No response

Dominant language
TypeScript
Stars
20.9k
Forks
68.8k
Avg merge
13h 43m
Merged PRs (30d)
110

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from github/docs

All issues in github/docs

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.