Editing and collaborating on issues

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

As well as learning the basics of editing and commenting on issues, this page can help you 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

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.

tip/resting Created with Sketch.

To attach files, create subtasks, and link issues in the new issue view, use the quick-add buttons below the issue summary.

  1. Quick add buttons: Add attachments, subtasks, linked issues, and content from Atlassian Marketplace apps.

Collaborating on issues

Keep your team informed by using the () to share an issue with other Jira users.

To invite members of your team to help you work on an issue, mention them by typing @ and their username in the issue description or comment. The people 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 and modify the issue details. 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— to see the Comment button—you must have both of the following project permissions for the issue's relevant project:

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

You automatically become a watcher of the issues you comment on. You can disable the autowatch option by going to Your profile and settings () > Personal settings.

 What How 
Add a comment

Click Comment.


Delete a comment

Hover over the comment, click more (•••) > Delete, then click Delete on the confirmation dialog.

Edit a comment

Hover over the comment, click more (•••) > Edit. In the edit dialog, edit the text as desired, then click Save.

After you've saved, you'll see "edited" next to the comment's timestamp. Hover over "edited" to see the details of who edited the comment and when.

Restrict a comment

Follow the instructions for editing a comment above. In the edit dialog, click the lock icon and choose the group or project role to restrict the comment to.

In Jira Service Desk, you can restrict comments to your team by choosing Comment internally.

Link to a comment

Hover over the comment, click more (•••) > right-click Permalink then copy the link address.

Paste the copied permanent link wherever you like. Clicking the permanent link will take you to that particular comment in the issue. This is particularly useful if there are a lot of comments on an issue.

Formatting text with wiki markup

The editor in the new issue view uses markdown rather than wiki markup. Right now, if you've added wiki markup in the old editor, we'll render it correctly in the new issue view.

As we continue to roll out the new issue view and new editor, wiki markup support will be phased out and eventually removed in favor of 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. Your Jira administrator can enable, disable and configure the renderer that allows you to use wiki markup, so your options may vary slightly.


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:

You can click a label (office-support in the above screenshot, for example) to jump to the Issue Navigator and see a list of all issues with this label.

tip/resting Created with Sketch.

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. 

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.

tip/resting Created with Sketch.

To watch an issue in the new Jira issue view, click the Watch icon at the top-right.


Last modified on Jul 8, 2018

Was this helpful?

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