Skip to main content

Comments

You can read and write comments in the pull request diff viewer, in the standard code editor (for files that belong to an open pull request), and in the Comments tab of the details panel.

Creating Comments​

To add a comment on a line, click the gutter icon in the diff viewer or use the Create Comment for Line action. You can also select a range of lines to create a multi-line comment.

The comment editor has two buttons:

  • Submit — sends the comment to Bitbucket immediately.
  • Save Draft — saves the comment locally without submitting. Drafts are only visible to you. You can submit all saved drafts at once using Submit All Drafts in the toolbar.

Reviews​

You can batch multiple comments into a single review so the pull request author receives one notification instead of many.

Check Start review when creating your first comment. All subsequent comments will be added to the review automatically. When you are done, click Finish review to publish all review comments at once. You can also set your review status when finishing:

  • Approve — approve the pull request.
  • Needs Work — request changes from the author.

Tasks​

You can create tasks from comments. Tasks act as a checklist — each task can be resolved independently. You can also convert a comment into a task and vice versa.

On Bitbucket Cloud, tasks can be created directly from a comment or by highlighting text in a comment and selecting Create task.

Resolving Comments​

Comment threads can be resolved and reopened individually.

Comment Actions​

  • Reply — respond to an existing comment thread.
  • Edit / Delete — modify or remove your own comments.
  • React — add an emoji reaction (full emoji support on Data Center; likes only on Cloud).
  • Copy Link — copy the comment URL.
  • Jump to Diff — navigate to the corresponding line in the diff viewer.
  • Jump to Source — navigate to the corresponding line in the editor.
  • Jump to Original Diff — navigate to the diff at the revision where the comment was originally made.
  • Minimize — collapse the comment.