Working with issues
What is an issue?
Different organizations use Jira to track different kinds of issues, which can represent anything from a software bug, to a project task, or a leave request form.
Issues are the building blocks of any Jira project. An issue could represent a story, a bug, a task, or another issue type in your project.
Here's an issue in a Scrum backlog:
- Selected issue: Select an issue to view its details.
- Backlog: Estimate issues and plan your sprints.
- Issue actions: Move an issue, clone it, log time spent working on it, and perform other actions.
- Issue details: See the assignee and description, make comments, and add content to the issue.
We're gradually rolling out a new issue view, which you may see on your boards, backlogs, and in the full-page issue view. The issue detail view will look a little different, some procedures will change slightly, and we have a new editor with markdown support. Take a look at our info page to see what's changed and get the latest updates.
Here's an issue in the full-page view:
- Quick-add buttons: Add attachments and subtasks, and link issues.
- Watch and more actions: Watch the issue, and perform other issue actions like move and clone.
- Transition issues: Quickly get from to-do to done, and any status or workflow step in between.
- Contextual information: Issue labels, components, time tracking, and more.
- Docked comment bar: Always there, so you can quickly add a comment no matter how far you've scrolled.
Note the following details:
- The issue detail view may show different fields to the full view, if it has been customized by your administrator.
- To see the full view, open the issue in a new tab/window by clicking the issue key.
Most information on an issue is self-explanatory. Here are a couple of things to be aware of though:
This panel will be shown on the issue, if your administrator has set Time Tracking to 'Remaining Estimate and Time Spent'. If an issue has sub-tasks, the Remaining estimate for the issue plus sub-tasks is rolled up into the parent issue.
The History tab of an issue records the following information: creator of the issue (this may be the same as the reporter, but can be distinct), changes to an issue field, attachment of a file, deletion of a comment, deletion of a worklog, creation or deletion of an issue link.
The Activity tab has the same information, plus additional information, such as comments. However, this may load more slowly, especially if there has been a lot of activity on the issue.
Check out the following pages to reach issue ninja status:
- Attaching files and screenshots to issues
- Creating issues and sub-tasks
- Customizing the issues in a project
- Editing and collaborating on issues
- Logging time on issues
- Estimating an issue
- Flagging an issue
- Ranking an issue
- Transitioning an issue
- Printing issue cards
- Viewing the development information for an issue
- Referencing issues in your development work
- Processing issues with Smart Commits