Editing and collaborating on issues

Work on your issues more efficiently with these tips and tricks for editing and collaborating on issues.

In addition to learning about the basics of editing and commenting on an issue, you can refer to this page for help with:

  • Using the wiki toolbar to make your comments and descriptions pop
  • Sharing issues with your team and mentioning other people
  • Keeping track of issues with labels and issue watchers

On this page:

Attaching files and screenshots

If your administrator has enabled file attachments, you and your customers can attach files and screenshots to issues you're working on. See Attaching files and screenshots to issues for more information.

Collaborating on issues

Sharing issues with other users

You can easily keep your team informed by sharing issues with them via email.

To share the issue:

  1. In the upper-right corner of the screen, select the Share  button.

  2. Enter usernames or emails of users that you want to share the issue with.

  3. Select Share.

If your administrator has enabled anonymous access to your project, you can also share issues by entering the email address of a non-Jira user.

You can easily keep your team informed by using the Share () button to share an issue with other Jira users. If your administrator has enabled anonymous access, you can also share issues by entering the email address of a non-Jira user.

Mentioning users on issues

If you want to invite members of your team to help you work on an issue, you can mention them by typing @ and their usernames in the issue description or comment.

People already involved in the issue, like the reporter or a commenter, will be listed first in the user list so you can select them faster. Note that the users you mention will be notified once you save the issue description or comment. 

Editing issue details

What permissions do you need?

To edit an issue, you need the Edit Issue project permission for the issue's relevant project. If you do not have this permission, please contact your administrator. 

To edit an existing issue, select Edit to open the Edit Issue dialog box and modify the issue details. If you want to change the fields you need to edit, select Configure fields > Custom and choose the fields you want to show or hide. Select Update to save your changes.

Commenting on issues 

What permissions do you need?

To add comments to an issue, you must have the following permissions for the relevant project:

  • Browse project permission to view the issue you want to comment on.

  • Add comments permission to add a comment to the issue. Without this permission, you won’t see the Comment button.

You can add and manage comments in the issue view.

  1. Edit, delete, or pin comments.
  2. Sticky comment footer: Add a new comment to an issue.
  3. Sort comments: display comments from newest or oldest first, or vice versa.

Add a comment

Open the issue you want to comment on and add a comment in the way you prefer:

  • Start typing your message in the sticky comment footer.

  • Press m to jump straight to the comment footer and start typing your update.

In Jira, you automatically become a watcher of the issues that you’ve commented on. To disable this:

  1. Select your user name in the upper right corner of the screen, then select Profile.
  2. In the Preferences section, set Autowatch to Disabled.

Delete a comment

Open the issue you’ve commented on, find the comment you want to remove, and then select Delete at the bottom of the comment. Confirm that you want to remove this comment from the issue by selecting Delete when prompted.

You can’t delete comments added by other users.

Edit a comment 

Open the issue, select Edit at the bottom of your comment, and edit the text or restrictions (Viewable by...) as needed. When you save your revised comment, you’ll see the text “edited” next to the comment date, indicating that the commment has been edited.

You can hover over “edited” to see who edited the comment and when.

Pin a comment

To pin comments on issues, you need to have the Edit Issue permission.

Open the issue, Select Pin at the bottom of the comment to display it above all other comments.

After you pin a comment, it’ll appear in the Pinned comments section at the top of the Comments tab. The All comments section contains all issue comments, including pinned ones.

tip/resting Created with Sketch.

Pinned comments aren’t sortable and the recently pinned ones will always appear at the top.

You can unpin, edit, and delete a pinned comment either in the Pinned comments or All comments section. You can also change the restrictions of pinned comments, making them visible only to particular groups of users.

Link to a comment 

Right-click on the comment timestamp, and then copy the link address. Paste the copied permanent link into your email or chat message.

Clicking the permanent link takes you to that particular comment in the Jira issue. If your Jira issue contains an extensive list of comments, the issue page will automatically be scrolled down so that the linked comment is visible.

Restrict a comment

Apply viewing restrictions to a comment by selecting the open padlock icon  (or  if restrictions already apply). 

Formatting text with wiki markdown

Jira application Text Formatting Notation allows you to use rich-text features, such as:

  • Italic, bold, underlined text
  • Multiple levels of headings
  • Bullets, numbered lists, tables, and quotations
  • Images
  • Macros

When you edit an issue description, comment, or any rich-text field, you can expand the simple wiki editor toolbar to format your text and select preview to see how your formatted text will appear. Note that your Jira administrator can enable, disable and configure the renderer which allows you to use wiki markdown, so your options may vary slightly.

HTML macro

When using the HTML macro, which allow you to add HTML code to an issue, you should only use formatting as if you are including something inside the {{<body>}} directly. This prevents you from accidentally breaking the page formatting, or overriding Jira's CSS.

Note that if you're administrator has enabled the rich text editor, you'll still be able to format your content using wiki markdown, but if you select the visual editor, you'll see the markdown applied directly.

Tracking issues with labels

Labeling helps you categorize and search for an issue. When viewing an issue, select More > Labels to add or remove labels, which will appear in the Details section:

Details section of an issue.

You can click a label (e.g. doc in the above screenshot) to jump to the Issue Navigator and see a list of all issues that have this label. You can also add the Labels Gadget to your dashboard to quickly find issues with labels relevant to you and your team.

Watching and voting for issues

What permissions do you need?

To view other users watching or voting for an issue, you need the View Voters and Watchers and Manage Watcher List project permissions.

If your administrator has set up the needed notification scheme, you can select Start watching this issue to be automatically notified of issue updates. You can also click the number of watchers on the issue to add other Jira users as watchers. 

With the granted permissions, you can add other users as watchers to the issue. The user picker in the Watchers field will only list users who have access to the project the issue belongs to.

If your administrator has enabled the voting on issues, you can select Vote for this issue to encourage the responsible team to resolve or complete the issue.

Reordering sub-tasks on an issue

If you've added sub-tasks to an issue, and need to reorder them, you can drag and drop them on the issue navigator view of the parent issue. If you're using a board in Jira Software, you can also reorder the sub-tasks on the board view. However, these two methods are independent of each other. Reordering sub-tasks on the parent issue will not reorder tasks on an existing board, and vice-versa.

Last modified on Jul 31, 2023

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.