Skip to main content

Enterprise managed settings in-product validator

By Steven Van ·

A new validator flags malformed JSON, bad team mappings, and other errors in GitHub Copilot's enterprise managed settings files.

GitHub Copilot's enterprise managed settings now include an in-product validator that checks copilot/managed-settings.json, copilot/team-mappings.json, and any team settings files the mappings file references. It flags malformed JSON, unsupported configurations, invalid team mappings, and other errors that stop policies from being enforced, with each issue pointing to the affected file and JSON path.

Results appear in the "Copilot settings validation" section of the enterprise AI controls page, under the Agents tab. After fixing an issue, admins commit the change to the default branch of their .github-private repository and reload the Agents page to confirm the configuration is valid. If no issues are found, the validation section doesn't display at all, and if validation is temporarily unavailable, existing settings continue to apply. This is covered in GitHub's documentation on enterprise managed client settings, as part of setting up GitHub Copilot governance.

GitHub
GitHub
Where the world builds software — Git hosting, pull requests, issues, Actions CI/CD, and Copilot, free for public and private repos.
View GitHub →

Read the original announcement →

Read Enterprise managed settings in-product validator on Creators Toolbox