You'll often be working on Jira issues as part of a team, so it's important you can share what's happening to keep your team up to date. You'll also need to keep up with the progress of issues you may not be directly working on. This is where watching, sharing, and comments come in.
Watching means you receive notifications when things happen on an issue. For example, when someone comments on, edits, or transitions the issue, you'll be notified.
To watch an issue, open it and click the watch icon permission, the watch icon also lets you view and manage the list of watchers on the issue. Add watchers to make sure they're informed of important issue updates.at the top right. If you have
Press W on your keyboard to quickly watch and unwatch 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.
You can choose whether or not to automatically watch issues you comment on or update. You can go to Your profile and settings ( to see and set your Watch your issues preference. ) > Settings
You can't manage watchers in the new issue view just yet, but we're working on it! For now, you'll need to click See the old view to do this.
The easiest way to share an issue is by grabbing a link to it and sending it using your favorite messaging app or email. Open an issue you want to share and hover your pointer over the issue key in the top-left corner (ABC-123, for example). You'll see a small copy icon pop out, which you can click to copy the link to the issue.
Comment on issues
Comments can range from simple text updates to let watchers know what's happening on the issue, to code snippets, images, tables, and more. The editor converts things like links, code, and markdown on-the-fly, so you can paste in your content and let the editor do the work.
Press M on your keyboard to jump straight into the comment field and start typing.
Common markdown formatting options:
- ## for H2 style (we support H2–H5)
- **bold** for bold
- *italic* for italic
- ``` for a code block
- [this is link text](www.atlassian.com) for this is link text
- * for bulleted lists (like this one )
- 1. for numbered lists
Mention your teammates
If you need someone to know about a comment, you can mention them in it. Type @ followed by their name, then choose the right person from the list. The person you mention will be notified about your comment and can quickly jump to the issue to see what's happening.
Apply comment permissions
If your comment is only meant for a specific Jira group or project role, comment permissions let you restrict your comments to the appropriate audience. When writing your comment, click the lock icon under it and choose a Jira group or project role to restrict it to.
- Comment permissions – Choose a group or project role to restrict your comment to.
React to comments 😍
Sometimes there's nothing more to say, and a 👍 or 🔥 to someone else's comment is all you need. You can quickly react using a popular set of emoji, or use the full emoji picker for a larger emotional range.
Click the add reactionbutton below a comment to react, and let the commenter know what you think 😉
Link to comments and work log entries
Save your team time and confusion by copying and pasting links to comments and work log entries.
To link to comments and work entries:
- Go to the issue view of an issue.
- Hover over a comment or work entry.
- Click copy ( ).
- Paste the link to your team.