| title | Commenting on a pull request | |||||||
|---|---|---|---|---|---|---|---|---|
| redirect_from |
|
|||||||
| intro | After you open a pull request in a repository, collaborators or team members can comment on the comparison of files between the two specified branches, or leave general comments on the project as a whole. | |||||||
| versions |
|
|||||||
| shortTitle | Comment on a PR | |||||||
| category |
|
You can comment on a pull request's Conversation tab to leave general comments, questions, or props. You can also suggest changes that the author of the pull request can apply directly from your comment.
You can also comment on specific files or sections of a file in a pull request's Files changed tab in the form of individual line or file comments, or as part of a pull request review. Adding line or file comments is a great way to discuss questions about implementation or provide feedback to the author. For more information about pull request reviews, see AUTOTITLE.
For more information on adding line or file comments to a pull request review, see AUTOTITLE.
Note
If you reply to a pull request via email, your comment will be added on the Conversation tab and will not be part of a pull request review.
To reply to an existing line or file comment, you'll need to navigate to the comment on either the Conversation tab or Files changed tab and add an additional comment below it.
Tip
- Pull request comments support the same formatting as regular comments on {% data variables.product.github %}, such as @mentions, emoji, and references.
- You can add reactions to comments in pull requests in the Files changed tab.
{% data reusables.repositories.sidebar-pr %}
-
In the list of pull requests, click the pull request where you'd like to leave line comments. {% data reusables.repositories.changed-files %} {% data reusables.repositories.start-line-comment %} {% data reusables.repositories.multiple-lines-comment %} {% data reusables.repositories.type-line-comment %} {% data reusables.repositories.suggest-changes %} {% data reusables.repositories.start-file-comment %}
-
When you're done:
-
If you only want to add this one comment, click Add single comment.
-
If you want to add multiple comments, click Start a review, then continue adding comments.
When you have finished, click Finish your review at the top right of the page, leave a summary of your review, and click Submit review.
-
Anyone watching the pull request or repository will receive a notification of your comments. Batching your comments avoids multiple notifications being sent. {% ifversion copilot %}If you are commenting on a pull request created by {% data variables.product.prodname_copilot_short %}, batching your comments prevents {% data variables.product.prodname_copilot_short %} from starting to work on individual comments before you have completed your review. See AUTOTITLE.{% endif %}
You can resolve a conversation in a pull request if you opened the pull request or if you have write access to the repository where the pull request was opened.
To indicate that a conversation on the Files changed tab is complete, click Resolve conversation.
The entire conversation will be collapsed and marked as resolved, making it easier to find conversations that still need to be addressed.
If the suggestion in a comment is out of your pull request's scope, you can open a new issue that tracks the feedback and links back to the original comment. For more information, see AUTOTITLE.
You can discover and navigate to all the conversations in your pull request using the Conversations menu that's shown at the top of the Files Changed tab.
From this view, you can see which conversations are unresolved, resolved, and outdated. This makes it easy to discover and resolve conversations.
