Skip to main content

Pull Request 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 Discussions tab of the details panel.

Viewing Comments​

How comments are displayed is configured separately for the diff viewer, the standard editor, and the Discussions tab.

In the diff viewer​

Right-click the diff gutter to toggle either option:

  • Show Comments Inline — display comment threads expanded directly in the diff. When turned off, comments are collapsed to gutter icons that you click to open. This preference is global and also available as Show comments inline in diff in Settings | Bitbucket Integration Pro.
  • Show Comments from Earlier Commits — when you have filtered the diff to a specific commit or commit range, comments made against other commits are hidden by default. Turn this on to show them in the current diff. Also available from the Comments in Diff Visibility menu on the diff viewer toolbar.

In the standard editor​

For a file that belongs to an open pull request, right-click the editor gutter and use the Show Comments submenu to choose how comments appear:

  • Inline — show comment threads expanded in the editor.
  • Gutter icons — show a clickable icon in the gutter (default).
  • Don't show — hide comments in the standard editor.

This preference is global and also available as Show comments in Settings | Bitbucket Integration Pro.

In the Discussions tab​

Comments Visibility on the tab toolbar toggles Show Outdated Comments — comments attached to lines that later commits have changed. They are shown by default.

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. Click on another line to select the range of lines to create a multi-line comment. On Bitbucket Data Center, multi-line comments require version 9.2 or later.

Submit sends the comment to Bitbucket immediately. Save Draft keeps it locally instead; drafts are visible only to you, and Submit All Drafts in the toolbar sends them all at once.

Reviews​

You can batch multiple comments into a single review so the pull request author receives one notification instead of many. On Bitbucket Data Center, reviews require version 7.7 or later.

Check Start review when creating your first comment. Subsequent comments are added to the review automatically, until you click Finish review to publish them all at once — optionally setting your review status (Approve, or Request Changes on Cloud / Needs Work on Data Center).

Tasks​

Tasks act as a checklist for the pull request — each task can be resolved independently. How tasks relate to comments differs between platforms:

  • On Bitbucket Cloud, a task is attached to a comment. When writing a comment, select Create task to attach one or more tasks to it. You can also highlight text in an existing comment and select Create task to turn that text into a task.
  • On Bitbucket Data Center, a comment itself can be a task. When writing a comment, select Is task to mark the whole comment as a task.

Resolving Comments​

On Bitbucket Cloud, and on Bitbucket Data Center 8.9 or later, comment threads can be resolved and reopened individually. When replying to or creating a comment, select Resolve discussion (or Reopen discussion) to change the thread's status together with your comment.

On earlier Data Center versions, threads cannot be resolved directly — use tasks to track items that still need attention.

Comment Actions​

A comment offers Reply, Edit and Delete for your own comments, Copy Link, Jump to Diff, and Minimize, plus:

  • React — full emoji reactions require Bitbucket Data Center 7.7 or later; Bitbucket Cloud and earlier Data Center versions support likes only.
  • Jump to Source — go to the line in the editor. Requires the repository to be associated with a local VCS root.
  • Jump to Original Diff — go to the diff at the revision where the comment was made.