Review requests can contain more than just code. They're a great place to review screenshots of your changes, documentation, mockups, log files, sample data sets, and more.

You can upload any number of file attachments to review requests. Images, text-based file attachments, and PDFs (on the Medium or higher plans) can be reviewed, just like code. Any other type of file can be downloaded and commented on as a whole.

Uploading Files

Uploading files is really easy. Simply take the files from your file manager and drag-and-drop them right onto the review request.

You'll see thumbnails begin to appear as the files upload.


File attachments uploaded to a review request appear as thumbnails below the Testing Done field.

By hovering over these thumbnails, you can see options for updating, reviewing, downloading, or deleting the file attachment. (If you're the reviewer and not the owner of the review request, you won't be able to update or delete it.)

Hovering will also reveal more of the file. For example, if you have a long screenshot of a webpage, hovering over the thumbnail will scroll more of the screenshot into view, giving you a bigger picture before you go to review it.

Updating Existing Files

If you've made an update to a file (such as editing some text in a text-based attachment or taking a new screenshot), you can update the existing file attachment entry with the new file as a new revision, much like with a diff.

To do this, hover over the thumbnail and choose Update. You can then browse for the newly-updated file.

The existing file attachment thumbnail will be repurposed for the new file. The updated file attachment will be shown along with any other changes when the review request is published.

Reviewing Files

To review a file, click on its thumbnail. If it's a reviewable file, you'll be taken to the review page for it. On this page, you'll be able to look through the file and make comments, much like you would with a diff. The capabilities for the review differ based on the file type.

For images and text-based attachments, reviewers will be able to view a diff between any two revisions of an uploaded file attachment, just like with diffs. This will help them see how your work has evolved over time.

Reviewing Text Files

Text files are shown similarly to diffs. You'll see line numbers besides each line, and you can click-and-drag to leave comments across the lines. If possible, the file will also be shown with syntax highlighting.

Markdown files have an additional mode allowing you to view the rendered content, helping get a good preview of how the document will look.

If there are multiple revisions of a text file uploaded, you can drag a revision slider (just like in the diff viewer) to view any desired revision, or to view a diff between the revisions.

Reviewing Images

When reviewing images, you can leave comments on any region by simply clicking-and-dragging, much like a selection tool in a graphics program. After you've left your comment, but before you've published, you can reposition or resize your comment's region.

If there are multiple revisions of an image uploaded, you can use the revision slider to view any revision, or you can even diff between them.

Image diffs have several modes:


Two-up diffing simply places the two revisions of the image beside each other.


Difference diffing displays a new image where each pixel color is the RGB (Revision X - Revision Y) difference of the two image revisions.


Split differing provides a horizontal slider to "wipe" a vertical divider left to right from one image revision to another. The first revision will be on the right of the slider line, and the second revision will be on the left.

Onion Skin

Onion Skinning uses a horizontal slider to "fade" from one revision image to another. When the slider is at the half way point, you will see a both image revisions semi-transparently overlaid on top of each other. Moving in a given direction will fade one image in and the other out.