Commenting mode

Learn how you can add comments to take teamwork to the next level

Tanya from UXPressia avatar
Written by Tanya from UXPressia
Updated over a week ago

The commenting mode is supposed to bring even more collaboration to your mapping and persona creation processes and improve the quality of your teamwork. Here is how you use it.

Switching to the commenting mode

Click the ‘COMMENTS’ button in the toolbar to switch to the commenting mode.


⚠️ Note: You can’t edit the document when the commenting mode is on.

Whenever the commenting mode is on, you will see the comments panel on the right side of the screen. This panel shows the list of comments added to a map or persona.

Screenshot_5 2.png

You can filter comments by their status (open or resolved) and authors.

Screenshot_6 1.png

Comments will be visible to everyone who has access to the document. Besides that, they can resolve comments, reply to them, and add their own.

Adding comments

To add a comment, switch to the commenting mode and click anywhere on the document. This action will leave a comment marker and expand the post-comment dialog:

Group 1791.png

⚠️ Note: Comments are pinned to the part of the map/persona you leave them on (e.g., sections, stage titles, persona sidebar, etc.). If you move or delete this part of the document, the comments pinned to it will be moved or deleted accordingly.

Types of comments

You can leave both text and audio comments.

_ 35(2).png

Leaving comments

To create a comment, switch to the commenting mode and click on any place inside the document to see the commenting window:

_ 37(1).png

When adding text comments, you can mention teammates with @ and use Markdown for text formatting.

To record an audio comment, click on the microphone icon.

Group 1792.png

Allow accessing your microphone and start talking. Stop the recording when you're done.

Screenshot_9 4.png

⚠️ Note: Only logged-in users can record audio comments.

Viewing a comment thread

To view a comment thread, click on any comment in the comments panel. This will open another window showing the comment and its answers.


⚠️ Note: Users with a Viewer role and people who visit your documents via a direct link with editing access can view your comments and reply to them.

Editing and deleting comments

To edit/delete a comment, open the comment thread, click on the menu icon next to the “Resolve” button, and select either “Delete” or “Edit”.


⚠️ Note: Only comment authors can edit/delete their comments.

Resolving comments

To resolve a comment, open the comment thread and click on the “Resolve” button.


The comment will get into the “Resolved” count in the comments panel. You will then be able to reopen it if needed.

Comment notifications

Whenever someone adds a new comment to the document you have access to, replies to your comment, or mentions you in a comment thread, you’ll receive an in-app notification. The notification list is under the top-left drop-down menu.

viewing comments.gif

Additionally, you can set up Slack notifications for these events.


Besides comments, you can add reactions — visual elements used to mark specific parts of a document.

_ 35.png

To add a reaction to a map or persona, choose the reaction you want to use, then find a fitting place, and click on it to leave your reaction there.

_ 39.png

To delete a reaction, click on it and hit the ‘Delete’ button on your keyboard.


If you want to let others know that you placed the reaction, use the sticker with your avatar to place it next to the reaction:

_ 37(2).png

The result will look like this:

_ 38.png

Dot voting

Choose the dots’ color and add those to the map or persona the way you add reactions.

_ 35(1).png

⚠️ Note: You can see comments only when you're in the Comments tab of the panel. When you're in the Reactions tab, you see only reactions and dots.

Did this answer your question?