Altium Designer Documentation

Enhanced Document Commenting

Modified by Rob Evans on Jan 6, 2021

In conjunction with the recent updates made to Commenting features in an Altium 365 Workspace, Altium Designer now offers a parallel set of revised and enhanced Commenting capabilities when connected to an Altium server. Commenting in the design space has been notably improved in terms of graphics, usability and relevant information, and remains backward compatible with previously placed comments.

► See Document Commenting in Managed Projects for more information on working with Comments in Altium Designer.

Below is a selection of notable feature points for the updated commenting system, as shown in the following video example:

  • Placement: Comments are now placed in the editor space from a single command button available in the updated Comments panel. When in comment placement mode, the cursor detects and highlights objects for selection:
    • Click a highlighted object to open the comment entry dialog – the comment will apply to the selected object.
    • Click in an un-highlighted area to open the comment entry dialog – the comment will apply to that specific point.
    • Alternatively, click away from an object, drag the cursor to create a highlighted area, and then click again to confirm its final shape and open the comment entry dialog – the comment will apply to objects within the specified area.

Select to confirm the comment entry. Note that placed comments are included as selectable summary entries in the Comments panel.

  • Mentions and Assignments: Along with any entered text in the comment entry dialog, you can add a 'mention' reference to any other user or role registered with the connected Workspace by entering the @ character or clicking the button. Select a name/email from the dropdown list to add the user (team member) reference to the comment, and also as an Assign To entry. Uncheck the latter option if you do not wish the comment to be regarded as specifically assigned to that user. A Role group (say, 'Engineers'), and therefore its constituent users, may also be added as a mention and/or assignment.
    If a mentioned user does not have access to the current project you will be invited to share it with that user. User Access Rights are granted through the Share dialog, and the user will receive an email notifying them of the shared access.
    See more information about sharing a design.
  • Positioning: A comment's location in the editor space is moved by dragging its associated 'pin' to a new position. When selected, the comment pin includes a connecting line to its associated object or area. Use the button in the Comments panel to toggle the visibility of pins (and their associated comments) in the editor workspace.
  • Drawing: When placing or editing a comment, select the option button to add freehand drawing with the resulting pen cursor. Right-click to finish and associate the drawing with the currently select comment.

Placing a Comment, including mention of another user, moving the comment Pin, and adding a freehand drawing to that comment.

To open an existing comment (from yourself or another team member), click on its pin in the editor space or its entry in the Comments panel. The below feature overview points can be seen in the video that follows:

  • Preview: Placed comments include a related preview image that was captured when the comment was first placed. The thumbnail image is opened from the Show original design screenshot link in the opened comment dialog.
  • Reply: An opened comment is inherently in reply mode, with the option to mention a Workspace user.
    • Click the button to add your entered response to the comment thread.
    • Click the button to Resolve (close as completed) the comment.
    • Click in the editor space to close the comment dialog.

Replying to a user comment while opening its preview image, and also mentioning another user.

More feature points for the new commenting system are listed below and can be seen in the following video:

  • Visibility: The visibility of comment threads is set by button in the Comments panel, which toggles both the visibility of the comment pins and the accessibility of the comment entries themselves.
  • Edit: An existing comment may be edited by the author of that comment using the Edit option available from the comment's menu. Click the button to confirm the comment edit.
  • Area comment: While in comment placement mode, click and drag the cursor to create a highlighted area, and then click again to confirm its final shape. The entered comment will apply to objects within the specified area.
  • Selection: A comment threads can be opened by selecting its entry in the Comments panel, or by clicking on its associated pin in the editor space. Sequentially move through comment entries by clicking on the < and > (previous/next) icons at the top of the comment entry dialog.

Toggling the visibility of comments, editing an existing comment, placing an area comment, and stepping through comments.

Use the options drop-down menu in the Comments panel () to configure comment visibility and notifications, and the associated button to toggle between the filtered and unfiltered view:

  • All – all comments placed on the design will be listed in the panel.
  • My – show only those comments that mention my user name and/or are assigned to my user name.
  • From – show comments placed by the selected user only.
  • Unresolved – comments that have been resolved are not included in the listing.
  • Current Document – show only comments that have been placed on the currently active document.
  • Notifications – receive email alerts for all comment activity in this design (All), for only those comments where you are mentioned or assigned (My), or do not receive email alerts at all (None).

Comments also can be placed on a board layout in the PCB editor space using the same placement approach to that in the schematic editor. When a comment entry is selected in the Comments panel, the system will open (and load if necessary) the associated design document.

Found an issue with this document? Highlight the area, then use Ctrl+Enter to report it.

Contact Us

Contact our corporate or local offices directly.

We're sorry to hear the article wasn't helpful to you.
Could you take a moment to tell us why?
You are reporting an issue with the following selected text
and/or image within the active document:
ALTIUM DESIGNER FREE TRIAL
Altium Designer Free Trial
Let’s get started. First off, are you or your organization already using Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

In that case, why do you need an evaluation license?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You actually don’t need an evaluation license for that.

Click the button below to download the latest Altium Designer installer.

Download Altium Designer Installer

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Please fill out the form below to get a quote for a new seat of Altium Designer.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

If you are on Altium Subscription, you don’t need an evaluation license.

If you are not an active Altium Subscription member, please fill out the form below to get your free trial.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Why are you looking to evaluate Altium Designer?

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

You came to the right place! Please fill out the form below to get your free trial started.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Great News!

Valid students can get their very own 6-month Altium Designer Student License for FREE! Just fill out the form below to request your Student License today.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.

That’s great! Making things is awesome. We have the perfect program for you.

Upverter is a free community-driven platform designed specifically to meet the needs of makers like you.

Click here to give it a try!

If would like to speak with a representative, please contact your local Altium office.
Copyright © 2019 Altium Limited

Got it. You can download a free Altium Designer Viewer license which is valid for a 6 months.

Please fill out the form below to request one.

By clicking “Get Your Free Trial”, you are agreeing to our Privacy Policy.
You may receive communications from Altium and can change your notification preferences at any time.