Starting from version 1.14.0, Smart Attachments add-on allows you to comment on attachments and document revisions in JIRA.

The commenting system is based on comment threads that are comprised of individual comments.

You can use the wiki markup for styling text in your comments, mention users and embed images.

Adding a New Comment Thread

You can start a new comment thread while:

To start a new comment thread in the issue view:

  1. Locate the attachment which you want to comment on.
  2. Hover over this attachment and click the Comment on Attachment icon . Alternatively, you can select Comment on Attachment from the contextual menu opened by clicking the down arrow icon.
  3. Enter a comment to start a new thread.
  4. Click Add. You can also submit the comment by pressing Ctrl + Enter.

To start a new comment thread in file preview:

  1. Locate the attachment which you want to preview.
  2. Click the attachment name.
  3. On the toolbar locate the Comments group and select it.
  4. Click +New comment thread.
  5. Enter the comment.
  6. Click Add. You can also submit the comment by pressing Ctrl + Enter.

Commenting on Attachment

  1. Locate the attachment you want to comment on.
  2. Hover over this attachment. 
  3. Click the View comments icon. Alternatively, you can select Comment on Attachment from the contextual menu opened by clicking the down arrow icon.
  4. Select the comment thread which you want to add a comment into.
  5. Enter your comment.
  6. Click Reply.

Commenting on Document Revision

Smart Attachments add-on allows you to comment on specific document revisions. You can both start new comment threads and add comments into the existing comment threads for the appropriate document revision. The generic mechanism of adding comments remains the same.

  1. Locate the document with revisions.
  2. Expand the document and locate the revision you want to comment on.
  3. Click the Coment on Attachment  icon or the View Comments  icon depending on availability of opened comment threads.
  4. Enter your comment and submit it.

Smart Attachments add-on tracks comment threads for each document revision. The latest document revision includes all the comment threads created since upload of the first revision.

While previewing the document, you can switch between document revisions and view only comment threads submitted for this revision and older revisions.

Editing the Comment

The action of editing comments is determined by project permissions granted to the user, as follows:

If you no permissions of the two mentioned above, you cannot edit comments in the thread.

To edit the comment in the thread:

  1. Open the comment thread.
  2. Locate the comment you want to edit.
  3. Click Edit.
  4. Update the comment.
  5. Click Save.

Deleting the Comment

The action of deleting comments is determined by project permissions granted to the user, as follows:

  1. Open the comment thread.
  2. Locate the comment you want to delete.
  3. Click Delete.
  4. Confirm the action.

Deleting the Comment Thread

The action of deleting the comment is determined by project permissions granted to the user, as follows:

  1. Open the comment thread.
  2. Locate the comment thread you want to delete.
  3. In the top right corner of the comment thread, locate the [...] icon and click it.
  4. Select Delete.
  5. Confirm the action.

Email Notifications about Comments

The add-on sends email notifications in the following cases:

  1. To users who are mentioned in the comments.
  2. To watchers of the issue when a new comment is added.

You can directly process to viewing the comment in the thread or add a new reply from the email.