Document review and markup
Review any saved version of a document, compare two versions side by side, mark up PDFs, and hold discussions that stay with the version they were about.
On this page
Every file in the Documents tool has a detail page where you review one exact version: preview it, compare it with another version, mark it up, and discuss it. Open Documents from the project’s Project Tools menu (or Files in the dock) and click a file name. For folders, uploads, check-out and permissions, see Documents and drawings.
Everything on this page is tied to a version. Uploading a newer version doesn’t move markup or discussions forward, and links to an older version keep opening that version.
The document detail page
The header shows the file name and the selected version’s Version, Size and Type, with these actions:
- Open file (new tab) opens the stored original.
- Review markup opens the markup workspace. It appears only for PDF versions.
- Compare versions appears when the file has more than one version.
Below the header are the version’s notes and the file description, then a preview. Images open with pan, zoom and rotate controls; PDFs open in the browser’s PDF viewer with zoom and page controls; text, Markdown, JSON and CSV files are shown inline (CSV as a table). Other file types show a download card. If the content can’t be shown to you, the page says “File content is unavailable here” and points you back to Documents.
At the bottom, Version history lists every version with its upload time (UTC), notes and size. Current marks the latest version and Viewing marks the one you’re on.
Review an earlier version
-
Pick the version
On the detail page, click Version 2 (or any number) in Version history. From the Documents list, open Version History on the file and click Review v2.
-
Check the banner
A banner reads “You are reviewing version 2. The current version is 3.” Click View current version to jump back.
-
Review as usual
The preview, markup, compare and discussion all work on the version you picked.
Compare two versions
Click Compare versions on the detail page. The compare page shows two saved versions side by side, each with its own preview and controls, its size, upload time and notes.
- Choose the Left version and Right version and click Compare versions.
- Swap sides switches them.
- Review version N and discussion under each side opens that version’s detail page.
The link keeps both version numbers, so it shows the same comparison after someone uploads a newer version. The comparison is visual: the app doesn’t highlight changes or sync scrolling between the two sides.
Mark up a PDF
Click Review markup on a PDF version. The banner confirms which version you’re marking up; annotations stay with that version and aren’t copied to newer files.
-
Choose a layer
Layer switches between Personal (only me) and Published (document viewers). Personal markup is private to you. Published markup is shared with people who can view the document.
-
Draw
Pick Select, Rectangle, Line, Freehand or Note. For a note, type the Note text, then click the page to place it, or use Add note near top left.
-
Fix mistakes
Undo and Redo step through your changes on this page and layer. Select an annotation (on the page or in the Page N annotations list) and click Delete Selected to remove it.
-
Save
Click Save. The status reads Unsaved changes until you do. Use Previous page and Next page to move through the PDF, and Document version to switch versions.
If someone else saved the same layer while you were working, saving is blocked until you click Reload saved markup. Your unsaved annotations stay visible so you can redo them.
If you only have view access, or the file is checked out by someone else, the workspace opens read-only: you can review saved annotations but not change them.
Discuss a version
Each version has its own Discussion section on the detail page. Messages stay with that version and are shared with people who can access the file.
-
Start a discussion
Open Start a discussion, enter a Subject and Message, and click Start discussion.
-
Reply
Under the thread, type in Reply and click Add reply.
-
Resolve or reopen
Resolve discussion closes the thread and records who resolved it and when. Reopen discussion brings it back.
To take part you need edit access to the document, and the file can’t be checked out by someone else. Without that, you can read discussions but not write in them.
Discuss an annotation
In the markup workspace, on the Published layer, select a saved annotation and click Discuss selected annotation. Save your changes first; unsaved and Personal markup can’t be discussed. The thread appears in the version’s discussion with View annotation on page N, which opens the markup on that page with the annotation selected. If the annotation is later changed or deleted, the thread stays and says so.
Take responsibility
Each open thread shows its Responsible reviewer, or “Unclaimed discussion”. Click Take responsibility to claim it. To hand it back, enter a Release reason and click Release responsibility; any editor with access to the version can do this, for example when the reviewer is away. Claiming a thread doesn’t approve the document or change anyone’s access, and anyone with edit access can still reply or resolve. Recent responsibility history lists the last 20 claims and releases.
Find open discussions
Click Open discussions at the top of Documents to see unresolved threads across files and versions, newest first. Search by File name or discussion subject, and narrow Discussions to All I can access, Started by me, My review work or Unclaimed, then click Filter discussions. Each result opens the exact version and thread. Resolved threads drop off the list.
Send versions on a transmittal
In Documents, click Select version N for transmittal under a file name (current version) or in Version History (any earlier version). You can pick up to 20 files, one version each. When you’re ready, click Prepare transmittal to open the transmittal composer with those exact versions; Clear selection starts over. Preparing sends nothing. See Transmittals.
Was this helpful?
Run it on your own project.
Start a 14-day free trial. Want a say in what ships next? Join the founding program.
14-day free trial. Pricing for paid plans isn't set yet. Talk to us. Already have an account? Sign in →