This page last changed on Aug 06, 2009 by rosie@atlassian.com.

Adding comments to an issue is a useful way to record additional detail about an issue, and collaborate with team members.

You can add comments to an issue as long as you have both of the following permissions:

  • 'Browse Project' permission — to view the issue to be commented on
  • 'Add Comments' permission — to add a comment to the issue

When adding a comment, you can also set the comment to be Viewable By members of a particular project role only; or you can allow all users to view it. For users to view a comment, they must have the 'Browse Project' permission to view the issue, and for each comment they must be a member of the Viewable By users (see 'Adding a Comment' below).

On this page:

Adding a comment

  1. Browse to the issue you wish to comment on.
  2. Click the Comment link under the Operations menu.
  3. Type your comment, and select which users can view this comment. Click the Add button.

    The Viewable By list will include all project roles¹ to which you belong. (Note: in this example, 'All users' means everybody who uses JIRA, while 'Users' means everybody who is a member of the 'Users' project role in this project.)
    ¹Depending on how your JIRA administrator has configured 'Comment visibility' , the Viewable By list may include groups as well as project roles.
The comment body can be rendered differently if your JIRA administrator has set up a Renderer. For details, see 'Editing rich-text fields'.

Hiding/showing a comment

Note that 'Hiding' or 'Showing' a comment refers to whether it is collapsed or fully visible (not to whether it is 'Viewable').

  1. Browse to the comment you wish to hide/show.
  2. To 'Hide' a comment, click the Hide link, located on the comment
  3. To 'Show' a hidden (collapsed) comment, click the Show link, located on the comment:

Editing a comment

Comments are editable if you are using JIRA version 3.8 or later. To edit a comment,

  1. Browse to the comment you wish to edit.
  2. Click the Edit link, located on the comment:
  3. Edit the comment as required.
  4. Click the 'Save' button.
  5. The word 'Edited' will be displayed to indicate that the comment has been edited. You can hover your mouse over the word 'Edited' to see who edited the comment and when, e.g.:

Note: you can edit your own comments if you have been granted the 'Edit Own Comments' permission. You can edit other people's comments if you have been granted the 'Edit All Comments' permission.

Deleting a comment

  1. Browse to the comment you wish to delete.
  2. Click the Delete link, located on the comment:
  3. Confirm the deletion by clicking the Delete button:

    Note: you can delete your own comments if you have been granted the 'Delete Own Comments' permission. You can delete other people's comments if you have been granted the 'Delete All Comments' permission.

Linking to a comment

Sometimes you may want to link to a specific comment within a JIRA issue. To do this,

  1. Browse to the comment you wish to link to.
  2. Click the Permlink link, located on the comment:
  3. The comment will now be highlighted in pale blue, e.g.:
  4. The URL in your browser's address bar will now look something like this: http://jira.atlassian.com/browse/TST-123?focusedCommentId=94796#action_94796
  5. Copy the URL from your browser's address bar and paste it into wherever you want to link from (e.g. an email).

Document generated by Confluence on Oct 06, 2009 00:25