# Comments It takes a team to build great diagrams. Comments help clarify parts of your diagram, mark inaccuracies, or share ideas. Everyone in your organization can leave, view and resolve comments to add to the discussion. {% hint style="info" %} Comments are only visible to an organization's admins, editors, and viewers. Share-link viewers can't see them. {% endhint %}

## Comment types There are 3 comment types in IcePanel. Each comment type can be used to discuss a particular topic: * Question - to discuss parts that you're unsure about. * Inaccuracy - to flag parts of the diagram that are incorrect. * Idea - to share thoughts about changes or improvements.

### Question comment type Questions should be used when you're unsure of part of the diagram, want to know how something works, or if something is unclear. Questions are added to the [recommendations tab](https://docs.icepanel.io/core-features/recommendation) to be resolved by your teammates.

### Inaccuracy comment type Inaccuracy comments should be used when something in the diagram or documentation is untrue or has changed. Each inaccurate comment reduces the [Inaccuracy Score](https://docs.icepanel.io/integrations/accuracy-score) of the landscape, and resolving them will improve it.

### Idea comment type Ideas are thoughts about future improvements to your architecture or diagram. For example, changes to a system or app to improve performance. Idea comments don't affect Inaccuracy Scores and can't be resolved (only deleted).

## Adding comments Comments can be added to any diagram and by all admins, editors, and viewers of your organization as long as they have access to a landscape. Share link readers **can't** add or view comments left by others. To add a comment in a diagram: 1. Click the comment icon in the top right of the navigation bar, then the `New comment` button. 1. Or, click on the `+` button on the left-hand toolbar. 2. Select the type of comment you want to add (Question, Inaccuracy, Idea). 3. Type in your comment. 4. Mention someone using '@'. They'll receive an email notification and see the comment under the Mentions tab in the comments dropdown 5. Click on the confirmation button. Each comment type button differs: * Question comment type: `Ask question` * Inaccurate comment type: `Mark as inaccurate` * Idea comment type: `Add idea` 6. Click and drag on the comment bubble to move it to the desired location. 7. Team members can reply to the comment in the comment box.

## Viewing comments If there are a lot of comments in a diagram or domain, you can quickly scan through them in the comment drop-down. To view all comments: 1. Click on the comment icon in the top right of the navigation bar 2. You'll see 3 tabs: * Your comments: Comments that you created * Mentions: Comments where you were mentioned * All comments 3. In each tab, you can sort through open and resolved comments

Viewing comments in the comment dropdown

## Editing comments To edit a comment: 1. Click on the comment bubble or find it in the comment drop-down. 2. Click on the pencil ✏️ icon. 3. Edit the comment. 4. Click on the checkmark button.

## Pinning comments Pinning a comment makes the comment text visible in the diagram. To pin a comment: 1. Click on the comment bubble or find it in the comment drop-down. 2. Click on the pin📍 icon in the top right of the comment box.

## Resolving comments Questions and Inaccuracy comments can be resolved to remove them from the diagram and reduce their effect on the Recommendation and Inaccuracy Score. To resolve a comment: 1. Go to the comment (must be a Question or Inaccuracy type). 2. Click the `Resolved ◻` check box. 3. The comment will be removed from the diagram.

Resolved comments can still be accessed from the comments drop-down: 1. Click on the comment icon in the top right of the navigation bar. 2. Click on the `All comments` tab. 3. Click on the `Resolved comments` section to view all resolved comments. 4. If you want to restore the comment, click the comment and Resolved checkbox. ## Deleting comments Only Idea comment types can be deleted. To delete a comment: 1. Click on the comment bubble or find it in the comment drop-down. 2. Click on the trash 🗑️ icon to delete it. 3. Deleted comments can still be accessed in the drop-down under the resolved section.

## Notification You’ll receive an email notification when: 1. **You’re mentioned in a comment**\ Someone mentions you using `@your-name` in a new comment. 2. **Someone replies in a thread you’re involved in**\ This includes threads where: * You started the conversation (you’re the original author), or * You were previously mentioned 3. **A comment is resolved**\ If you started the thread or were mentioned in it, you’ll be notified when it’s resolved. You **won’t** receive notifications when: * You’re the one who wrote, replied to, or resolved the comment