Commenting in Your Design
The ability to leave comments and tag project stakeholders in the design context provides visibility and better communication throughout the entire design process. You can add comments and also draw in an entire document or area in your design (available in Schematic and both 2D and 3D layout modes in PCB).
Once you share a project, all of the stakeholders can view and comment on the design from within Altium Designer, or through the Altium 365 web browser interface. Project participants not familiar with Altium Designer can review and leave comments by accessing the design via their web browser without having to install Altium Designer. All comments will sync across and appear both in the web view and within Altium Designer, always in the context of your design.
1. Commenting in Altium Designer
In the project tree on the left side, select the document you want to comment on.
There are several options to leave comments:
- There is an icon on the top right corner of your screen, next to the 'Share' button.
- Comment Panel > Place a Comment
- At the top menu bar, select Place > Comment and select the desired location with the crosshair cursor.
- Or use the shortcut Ctrl+Alt+C
There are three commands available for adding a comment:
- Comment for Area (Ctrl+Alt+A) - Allows you to make a comment that relates to a defined rectangular area on the active document.
- Comment for Point (Ctrl+Alt+P) - Allows you to make a comment related to a particular point on the active document.
- Comment for Object (Ctrl+Alt+C) - Allows you to make a comment that relates to a single selected component on the active document.
Tip: You can display the Comments Panel in Altium Designer by choosing View > Panels > Comments.
Enter your comment in the dialog box, then click Post to publish. You have an option to tag a user or to attach a freehand drawing (scroll down for detailed instructions).
To draw or edit a freeform shape, click the Pencil icon in the Comments dialog box. With the Pencil icon chosen, you will be able to write, underline, or draw a shape.
Tip: You can mention a specific user using the @ symbol before their email address in the comment, for example, @firstname.lastname@example.org. This user will receive an email notification.
Once the issue has been addressed, the comment can be resolved and hidden. To resolve the comment click ✓ in the upper-right corner of the comment then select Resolve. The comment will become hidden in the panel
Resolved comments do not disappear, but are hidden. To show all resolved comments, click the arrow in the upper-right corner of the Comments panel, then in the drop-down menu select the “Unresolved only” option.
2. Commenting via Altium 365 Web Interface
2.1. Accessing the Web Interface
All project stakeholders can access a design via the web browser without a need to install and license Altium Designer (you have full control over who has access to the project and can revoke access at any time). You have several options to access the Altium 365 web Interface:
2.2. Commenting via Web Interface
- Use the Alt+C keyboard shortcut.
- Near the “Share” button, there is an icon . This option allows you to “Comment for Area,” “Comment for Point,” or “Comment for Object.”
- At the right top corner, where the content is displayed, you can see this symbol:. This option allows you to open the Comments panel. To do this, just click on this icon :
There are multiple options to attach comments:
Comment for Area: This allows you to comment on a defined rectangular area on the active document. Select the required area by clicking and dragging in the design space.
Comment for Point: Left-click your mouse at any point of the design, and the dialog box will open to insert a comment.
Comment for Object: Left-click your mouse in any object of the design, and the dialog box will open to insert a comment. The comment will immediately be tied to that object.
Enter your comment in the Comments panel, then click Post to publish. You have the option to tag a person or add a freehand drawing (scroll down for details).
Resolved comments do not disappear, they are just hidden. To filter comments:
- All: Shows all comments
- My: Shows all comments added by you and comments you were tagged in.
- Unresolved only: Shows only unresolved comments
- Current document only: Shows only comments in the current document
- Notification settings: Select which comments in the project you want to receive email notifications for.
Tip: To ‘unresolve’ a comment click the ✓ in the upper-right corner of the comment. This comment will again display in the Comments panel.