Annotation replies and reviews
Table of contents
This post introduces annotation replies and reviews in Nutrient SDKs, enabling embedded discussions directly within PDF documents. The feature allows users to create threaded conversations on specific document sections instead of using messy single comments, with support for review states like accepted, completed, or rejected. This PDF comments SDK enhancement transforms static documents into collaborative platforms with modern mobile interfaces for iOS and Android.
The PDF standard allows documents to contain embedded discussions, thereby facilitating a wide range of document workflows. Today we’re delighted to bring full support for embedded discussions to mobile in Nutrient iOS SDK 7.5, Nutrient macOS SDK 2.5 and Nutrient Android SDK 4.5.
Reviewing PDF documents
Many PDF viewers can display single notes or comments in a document, but this is a messy format for conversation. With our PDF comments SDK, if a copy editor leaves a comment on a particular paragraph, there’s an easy way for the author to respond to it in place. With multiple comments scattered across the page, it quickly becomes near impossible to piece together the flow of conversation — something which is not at all conducive to discussion and quality output.
An option for people who don’t want to deal with the above is to have an exchange take place in a different channel, such as email. However, this can quickly become convoluted and chaotic; you’ll either need to keep quoting bits of text to be clear what’s being talked about, or else you’ll need to be hyperspecific, e.g. “the third paragraph after the big diagram on page six doesn’t make sense.”
Replies in Nutrient
Replies within a PDF make having a thoughtful conversation directly in the context of the document under review a straightforward process. Anyone can keep up with the flow of conversation and see exactly which detail in the document is being discussed.
Nutrient’s new built-in support allows for exactly this: Users can view, search, and add comments to a discussion in a document with a vibrant, modern user interface. Bringing this to mobile means everyone can have their say, regardless of where they are and what device they’re using.
The UI has been designed to perfectly blend into iOS:
On Android, we use a Material-design style dialog:
And because you often don’t have time to type lengthy responses on the go, the review feature makes it easy to give feedback. Users can leave simple review states on any comment: accepted, completed, cancelled, or rejected.
| iOS Set Status Menu | Android Set Status Menu |
|---|---|
 |  |
With a simple tap, you can quickly see the names of everyone who left a review.
| iOS Expanded Review Summary | Android Expanded Review Summary |
|---|---|
 |  |
Technical details
Nutrient also provides a low-level API for programmatic access to the properties stored in the PDF, enabling you to build custom solutions on top of replies and reviews. Nutrient implements annotation replies and reviews conforming to the PDF specification and is fully compatible with the same features in Adobe Acrobat(opens in a new tab).
You can read more about these details in our annotation replies and reviews guides for iOS and Android.
To see of all the features, improvements, and changes in detail, check out our iOS and Android changelogs.
