GitHub Copilot can review your code and provide feedback. Where possible, Copilot's feedback includes suggested changes which you can apply with a couple of clicks.
Copilot code review in Visual Studio Code supports two types of review:
Review selection: Highlight code and ask for an initial review
Review changes: Request a deeper review of all your changes
The current functionality and availability of the two types of review is summarized in the following table:
Review selection
Review changes
Available in
Visual Studio Code
Visual Studio Code and the GitHub website
Premium/standard feature
Standard feature available to all Copilot subscribers
Premium feature. Available with the Copilot Pro, Copilot Pro+, Copilot Business, and Copilot Enterprise plans. Per-person monthly quota applies.
Description
Initial review of a highlighted section of code with feedback and suggestions
The review changes type of Copilot code review is a premium feature with a per-person monthly quota.
Remarque
Billing for premium requests is coming soon. Until then, you can continue to use Copilot code review without being billed for additional premium requests. For the most up-to-date start date, see About premium requests.
When you assign Copilot as a reviewer for a pull request, one premium request is deducted from your monthly quota each time Copilot posts comments to the pull request. See About premium requests.
If a repository is configured to automatically request a code review from Copilot for all new pull requests, the premium request usage is applied to the quota of the pull request author. If a pull request is created by GitHub Actions or by a bot, the usage will apply to the user who triggered the workflow (if identifiable), or to a designated billing owner.
When you reach your monthly quota you will not be able to get a code review from Copilot until your quota resets—unless you upgrade your Copilot plan or enable additional premium requests.
Two types of Copilot code review are available:
Review selection: Highlight code and ask for an initial review (only available in VS Code)
Review changes: Request a deeper review of all your changes (available in VS Code and the GitHub website)
This version of the article relates to Copilot code review on the GitHub website. To see information about the review selection type of Copilot code review, click the "Visual Studio Code" tool switcher at the top of the page.
Copilot code review on the GitHub website is a premium feature, available with the Copilot Pro, Copilot Pro+, Copilot Business, and Copilot Enterprise plans.
The review changes type of Copilot code review is a premium feature with a per-person monthly quota.
Remarque
Billing for premium requests is coming soon. Until then, you can continue to use Copilot code review without being billed for additional premium requests. For the most up-to-date start date, see About premium requests.
When you assign Copilot as a reviewer for a pull request, one premium request is deducted from your monthly quota each time Copilot posts comments to the pull request. See About premium requests.
If a repository is configured to automatically request a code review from Copilot for all new pull requests, the premium request usage is applied to the quota of the pull request author. If a pull request is created by GitHub Actions or by a bot, the usage will apply to the user who triggered the workflow (if identifiable), or to a designated billing owner.
When you reach your monthly quota you will not be able to get a code review from Copilot until your quota resets—unless you upgrade your Copilot plan or enable additional premium requests.
Copilot isn't guaranteed to spot all problems or issues in a pull request, and sometimes it will make mistakes. Always validate Copilot's feedback carefully, and supplement Copilot's feedback with a human review.
These instructions explain how to use Copilot code review in the GitHub website. To see instructions for other popular coding environments, use the tool switcher at the top of the page.
On GitHub.com, create a pull request or navigate to an existing pull request.
Open the Reviewers menu, then select Copilot.
Wait for Copilot to review your pull request. This usually takes less than 30 seconds.
Scroll down and read through Copilot's comments.
Copilot always leaves a "Comment" review, not an "Approve" review or a "Request changes" review. This means that Copilot's reviews do not count toward required approvals for the pull request, and Copilot's reviews will not block merging changes. For more details, see Approving a pull request with required reviews.
Copilot's review comments behave like review comments from humans. You can add reactions to them, comment on them, resolve them and hide them.
Any comments you add to Copilot's review comments will be visible to humans, but they won't be visible to Copilot, and Copilot won't reply.
Where possible, Copilot's feedback includes suggested changes which you can apply with a couple of clicks.
If you're happy with the changes, you can accept a single suggestion from Copilot and commit it, or accept a group of suggestions together in a single commit. For more information, see Incorporating feedback in your pull request.
If you want to validate Copilot's suggested changes (for example by running automated tests or your linter), or if you want to make modifications before committing the suggested changes, click the Open in Workspace button. For more information, see Using Copilot to help you work on a pull request.
You can provide feedback on Copilot's comments directly within each comment. We use this information to improve the product and the quality of Copilot's suggestions.
On a pull request review comment from Copilot, click the thumbs up (👍) or thumbs down (👎) button.
If you click the thumbs down button, you're asked to provide additional information. You can, optionally, pick the reason for your negative feedback and leave a comment before clicking Submit feedback.
When you push changes to a pull request that Copilot has reviewed, it won't automatically re-review your changes.
To request a re-review from Copilot, click the button next to Copilot's name in the Reviewers menu. For more information, see Requesting a pull request review.
Remarque
When re-reviewing a pull request, Copilot may repeat the same comments again, even if they have been dismissed with the "Resolve conversation" button or downvoted with the thumbs down (👎) button.
By default, you manually request a review from Copilot on each pull request, in the same way you would request a review from a human. However, you can set up Copilot to automatically review all pull requests. See Configuring automatic code review by Copilot.
The custom coding guidelines feature is only available with the Copilot Enterprise plan, and is currently limited to selected customers.
When using Copilot code review to review changes in Visual Studio Code or the GitHub website, you can customize Copilot's review with custom coding guidelines written in natural language. Copilot will give feedback based on your coding guidelines when it reviews your code. For more information, see Configuring coding guidelines for GitHub Copilot code review.
Comments generated based on a coding guideline will include a message, highlighting their source.
These instructions explain how to use Copilot code review in Visual Studio Code. To see instructions for other popular coding environments, use the tool switcher at the top of the page.
Remarque
Copilot code review is only available in Visual Studio Code with version 0.22 or later of the GitHub Copilot Chat extension.
Where possible, Copilot's feedback includes suggested changes which you can apply with a single click.
If you're happy with the change, you can accept a suggestion from Copilot by clicking the Apply and Go To Next button. Any changes you apply will not be automatically committed.
If you don't want to apply Copilot's suggested change, click the Discard and Go to Next button.
You can provide feedback on Copilot's comments directly within each comment. We use this information to improve the product and the quality of Copilot's suggestions.
To provide feedback, hover over the comment and click the thumbs up or thumbs down button.
The custom coding guidelines feature is only available with the Copilot Enterprise plan, and is currently limited to selected customers.
When using Copilot code review to review changes in Visual Studio Code or the GitHub website, you can customize Copilot's review with custom coding guidelines written in natural language. Copilot will give feedback based on your coding guidelines when it reviews your code. For more information, see Configuring coding guidelines for GitHub Copilot code review.
Comments generated based on a coding guideline will include a message, highlighting their source.
These instructions explain how to use Copilot code review in Visual Studio. To see instructions for other popular coding environments, use the tool switcher at the top of the page.
To use Copilot code review, you must use Visual Studio version 17.14 or later. See the Visual Studio downloads page.
In the Git Changes window, click Review changes with Copilot.
This button appears as a comment icon with a sparkle.
Copilot will begin reviewing your changes. After a few moments, a link showing the number of code review comments appears in the Git Changes window.
Click the link to view and navigate the comments. If no issues are found, you’ll see the message:
Copilot did not comment on any files.
Copilot displays comments in your code with a summary of each potential issue. You can:
Review and make changes based on the suggestions.
Dismiss a comment using the downward arrow in the top-right corner of the comment box.
To remove all review comments, click next to the code review link in the Git Changes window.
For more information on enabling and configuring Copilot code review in Visual Studio, see Review local changes with Copilot Chat in the Visual Studio documentation.
