Comments in documents- Why is it useful and how to manage it?

Created by Inês Figueiredo, Modified on Wed, 07 Sep 2022 at 04:51 PM by Inês Figueiredo

The comment tool available on the My Documents module is the best way to communicate between document editors and users.


There are 2 key types of comments:

  • Comments that communicate a summary about document changes/reviews (Type A).
  • Optional comments between editors/approvers and document users (Type B).


Type A comments are identified with  dark grey  color. This type of comment is mandatory. Editors must submit the comment during the document's revision. 


Type B comments are identified with  light grey  color. This type of comment is optional. Any document user/reader can add comments to the document.


Document comments can be read by all document subscribers since all comments are public. Agir administrators and document administrators can delete all comments and the comment authors can delete their comments. However, any deleted comments remain on the document's timeline.



 TIP  Comments are used to communicate between editors, approvers and users, but they can work as a way of gathering suggestions regarding document improvements or revision requests. It is recommended that you delete comments between each revision.
 ATTENTION  Comments are public. You shouldn’t use the comment tool to communicate confidential information. Comments don’t emit alerts or send emails. However, you may enable a special notification service for new comments.
 PERMISSIONS  You only have to be a document consultant in order to view or write a document comment. However, comment deletion must be done by the document Owner/Editor/Administrator.
 TIP  Did you know that you can enable a notification service for new comments by email? This way you can follow comments and suggestions from your colleagues. Contact our team to enable this service.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article