How do I add comments to the document?

A quick tutorial on how to add comments on Avvoka

Moustafa avatar
Written by Moustafa
Updated over a week ago

During the course of a negotiation on Avvoka, you may want to add comments to certain sections of text to highlight them to your team, or to the Counterparty. You can also choose to assign tasks or mention specific users.

You can achieve this by highlighting the text you wish to comment on. Then, type your comment into the box on the right hand side of the document. Press “comment” when you are done.

What are 'Internal' and 'External' comments?

There are two types of comments that are available to users: Internal and External comments.

As a rule, all comments on Avvoka default to Internal, meaning that Only your side of the negotiation will be able to see them. When the document is eventually published, Internal comments are invisible to the Counterparty.

If you'd like the Counterparty to see your commentary, and reply to it in a thread, you will need to make your comment External. You can do this by clicking the eye button after you've written your comment. This means that when the document is sent to the Counterparty, they will be able to see the comments that you've left for them.

What are 'Tasks' and 'Mentions' in comments?

You can mention someone in a comment to draw their attention to the specific section. Create a comment in accordance with the section above. After this, type the "@" symbol and the desired user’s name or email in the comment box. The user will then receive an email notifying them that they have been mentioned in the document.

To assign a task to someone, click the user icon at the top right of the comment. You’ll now be able to select from a dropdown list of everyone on your profile for who you want to assign the task to. After you select the name and email from the drop down, the user will receive an email to let them know that they’ve been assigned a task.

Tasks that have been assigned to you will be marked in orange rather than the standard blue. This will help you to distinguish your tasks from others. You’ll also see that it says “Task assigned to Your Name” at the top.

Once you’ve completed a task, click on the ‘Mark as done’ button. Everyone on the profile will be able to see who the task was completed by.

Navigating the comment sidebar

Display of comments

By default, comments will be allowed to scroll independently of the document. However, you can choose to Force them to scroll with the document by clicking on the < > icon on top of the comment sidebar (marked in red below). You can always go back to the previous view by clicking on the icon again.

Finding the text associated with a comment

If you want to see which text is associated with a comment, simply click on the magnifying glass icon, the document will scroll to the relevant position, and the blue container with the text associated with the comment will be illuminated. The result will vary slightly depending of which display view of comments you have selected (see above).

What does this look like in practice?

Hint: Make sure you enable your audio so you can hear our voiceover explanation!

Did this answer your question?