Start (Request) a Code Review
As someone who requests code review from your teammates, you typically perform the following sequence of tasks:
Commit and push changes to your Git repository.
Create a code review. If you have committed your changes to a feature branch and now would like to merge it to a base branch (main, master), create a merge request.
Invite reviewers and wait for their feedback.
Discuss issues, if any, by way of exchanging comments with the reviewer(s).
Work on resolving the issues, commit the fixes, and add the new revision(s) to the existing review.
As soon as the reviewer(s) approve your changes, you close the review. If the review is a merge request, you merge your branch.
Go to the Commits tab. Recent commits are listed in chronological order.
Scroll down the list or use filters to find the revision you're interested in.
Select the revision entry, then click New code review:
tip
You can select multiple revisions to include them in the review at once (use CtrlClick), or add new revisions later.
A new review is created and opened:
The default code review title is the same as your commit (or the last commit in a multi-commit review) included in the review.
note
You can link a code review to an issue by mentioning the issue ID in the code review title. Read more about it in Link an Issue to a Commit or Code Review
In the next step you need to assign at least one reviewer to the review.
Assign reviewers by adding them to the reviewers list.
note
The selection of reviewers is limited to project members only. Non-members are not allowed to participate as reviewers or authors, however they can subscribe to a review and get notified of updates.
On the review page, click the plus icon and select one or more reviewers from the drop-down list:
The assigned reviewers will be shown on top of the review page.
The people you add as reviewers will be notified in their Chats.
Now you need to wait for the reviewer(s) to finish examining your changes. You'll be notified when they are done, and it's your turn to proceed.
You can invite others to watch updates and discuss changes by subscribing them to the review. Just mention them in a comment: type @ and pick a person from the list.
In a code review, participants take turns to keep the process clear and orderly. The status indicator under your name in the right-hand panel will tell you whether you should wait or take action.
Gray color indicates that no action is required, wait for the reviewer to finish their turn. | |
Orange color indicates that it's your turn, and you are expected to take some action such as:
Once you're finished, click the suggested action in the top right corner to change your status and pass the turn to the reviewer. | |
A blank status under your name indicates that the review is complete and can be closed. Click the Close review button in the top right corner. If the review is a merge request, click the Merge button to merge your branch and close the review. |
You can post comments, addressing them to other participants, and reply to the comments left by others. See Comments and Suggested Changes for details.
A review can contain multiple commits when:
The changes you want to be reviewed are spread across several commits.
The commit you had originally submitted for review was not approved by the reviewers. You can then work on the issues, commit fixes, and attach one or several new commits to the original review for approval.
This way the entire commit and discussion history is contained within one review, and as long as the review is open it will always be visible throughout the different commits.
When reviewers accept your changes, you are notified in Chats. Their resolution will be also posted on the review page under the Timeline tab, and indicated on their user icons (they will be encircled in green):
![reviewResolutionAvatar.png reviewResolutionAvatar.png](https://resources.jetbrains.com/help/img/space/reviewResolutionAvatar.png)
![reviewResolutionAll.png reviewResolutionAll.png](https://resources.jetbrains.com/help/img/space/reviewResolutionAll.png)
If all the reviewers have accepted your changes, the review is complete, and you are expected to close it. To close the review, click the corresponding button:
![closeReview.png closeReview.png](https://resources.jetbrains.com/help/img/space/closeReview.png)
If all the discussions in the review have been marked Resolved, the review will close by itself when all the reviewers accept your changes.
Technically, you can close a code review at any stage. For example, if you have created it by mistake. Just click and choose Close review:
![closeReviewFromMenu.png closeReviewFromMenu.png](https://resources.jetbrains.com/help/img/space/closeReviewFromMenu.png)
The Code Reviews page lets you keep track of the reviews you participate in or are expected to. Use filters to check which reviews need your attentions either as author or reviewer.
![gotoReviewsPage.png gotoReviewsPage.png](https://resources.jetbrains.com/help/img/space/gotoReviewsPage.png)
On this page, you can also see and search all reviews in the project.
Thanks for your feedback!