Jump to >

Reviewing Images


Much like diffs, portions of images can be reviewed. This is useful when presenting screenshots of a new dialog, for example, where the design and layout of the dialog is as important as the code constructing it.

To begin reviewing an image file, just click the thumbnail for the file attachment on the review request page.


Commenting on Regions

To place a new comment on part of the image, simply click and drag to select the desired area. This will pop open a new comment dialog, just like in the diff viewer.


Comments support rich text using the Markdown language. See Using Markdown for more information.

The file attachment comment dialog supports issue tracking. See the section on Issue Tracking for more information.

Once you’re done writing your comment in the text area, click Save to save the comment.

A rectangle with a green number box will appear in the region you selected to indicate that you have a comment in that area. Click the box to pop open the comment box for your existing comment again.

Reading Existing Comments

When your mouse cursor is over the image, regions representing other comments may appear with blue number boxes in the corner. Each of these is a comment someone has made on another review.

If you move the mouse cursor over the region, a tooltip will appear showing a summary of the comments made.

If you click on the region, the comment dialog will appear, along with a blue side panel on the left showing those existing comments. You can still write new comments in the green area of the comment box.


It’s important to note that this is not the place to reply to those comments. When you add a comment from the diff viewer, it’s creating a new top-level review (akin to a new thread). If you want to reply to existing comments, you can do so from the Reviews page. The Reply link here is a shortcut to jump directly to the relevant comment on the Reviews page.

The view here is meant to be used only as a reference to see if other people have already said what you plan to say.