JIRA

Install

Admin

Use

	JIRA User's Guide Introduction Concepts What is an Issue? Issue Type Priority Status Resolution What is a Project? Understanding Workflow Getting Started Exploring the JIRA Dashboard Using Keyboard Shortcuts Managing your User Profile Choosing a Language Changing your Password Working with Issues Creating an Issue Setting Security on an Issue Attaching a Screenshot Editing rich-text fields Logging Work on an Issue Scheduling an Issue Creating a Sub-Task Watching and Voting on an Issue Commenting on an Issue Linking Issues Cloning an Issue Viewing an Issue's FishEye Changesets Modifying Multiple ('Bulk') Issues Searching and Reporting Using Quick Search Using the Issue Navigator Saving Searches ('Issue Filters') Receiving Filter Results via Email Performing Advanced Searches Generating Reports Overview Browsing a Project's Road Map Browsing a Project's Change Log Browsing a Project's FishEye Changesets Browsing a Project's Popular Issues Browsing a Component's Open Issues Browsing a Component's Road Map Browsing a Component's Change Log Browsing a Component's Popular Issues Browsing a Version's Open Issues Browsing a Version's Summary Browsing a Version's Popular Issues Reporting on a Version's Time Tracking Reporting on a Version's Workload Reporting on a User's Workload Reporting on a Field in an Issue Filter Customising the Dashboard Overview Adding the Administration portlet Adding the All Filters portlet Adding the Assigned To Me portlet Adding the Bugzilla search portlet Adding the Calendar portlet Adding the Charting portlet Adding the Filter Statistics portlet Adding the 2D Filter Statistics portlet Adding the In Progress portlet Adding the Introduction portlet Adding the Project portlet Adding the Projects portlet Adding the Project Statistics portlet Adding the Project Table portlet Adding the Quick Links portlet Adding the Road Map portlet Adding the Saved Filter portlet Adding the Text portlet Adding the Voted Issues portlet Adding the Watched Issues portlet

What is an Issue?

PDF

Different organisations use JIRA to track different kinds of issues. Depending on how your organisation is using JIRA, an issue could represent a software bug, a project task, a helpdesk ticket, a leave request form, etc.

A JIRA issue typically looks like this:

Note

Your JIRA issues may look different to the above screenshot if your administrator has customised JIRA for your organisation.

The numbered fields shown in the above screenshot are:

Key — a unique identifier for this issue.
Type — see below for a list of types.
Status — the stage the issue is currently at in its lifecycle ('workflow'). See below for a list of statuses.
Resolution — a record of the issue's resolution (if the issue has been resolved)
Priority — the importance of the issue in relation to other issues. (See below for a list of priorities.)
Assignee — the person to whom the issue is currently assigned.
Reporter — the person who entered the issue into the system.
Project — the 'parent' project to which the issue belongs.

a. Component(s) (if applicable) — project component(s) to which this issue relates.
b. Affects Version(s) (if applicable) — project version(s) for which the issue is (or was) manifesting.
c. Fix Version(s) (if applicable) — project version(s) for which the issue was (or will be) fixed.
Summary — a brief one-line summary of the issue.
Environment (if applicable) — the hardware or software environment to which the issue relates.
Description — a detailed description of the issue.
Comments — added by people who are working on the issue.

Additionally, if your administrator has enabled 'Time-Tracking', the following fields will appear above the 'Description' field:

Original Estimate — the total amount of time required to resolve the issue, as estimated when the issue was created. (This field cannot be modified once work has been logged on the issue.)
Remaining Estimate — the remaining amount of time required to resolve the issue. This field only appears when work has been logged on the issue.
Time Spent — the sum of all the individual work logs for this issue. This field only appears when work has been logged on the issue.

Some of the most important fields — 'Type', 'Priority', 'Status' and 'Resolution' — are described as follows:

Issue Type

JIRA can be used to track many different types of issues. The default types are listed below, but please note that your JIRA administrator may have customised this list to suit your organisation.

Bug: A problem which impairs or prevents the functions of the product.
Improvement: An enhancement to an existing feature.
New Feature: A new feature of the product.
Task: A task that needs to be done.
Custom Issue: A custom issue type, as defined by your organisation if required.

Priority

An issue's priority indicates its relative importance. The default priorities are listed below; note that both the priorities and their meanings can be customised by your JIRA administrator to suit your organisation.

Blocker: Highest priority. Indicates that this issue takes precedence over all others.
Critical: Indicates that this issue is causing a problem and requires urgent attention.
Major: Indicates that this issue has a significant impact.
Minor: Indicates that this issue has a relatively minor impact.
Trivial: Lowest priority.

Status

Each issue has a status, which indicates where the issue currently is in its lifecycle ('workflow'). An issue starts as being 'Open', then generally progresses to 'Resolved' and then 'Closed'; or, depending on circumstances, it may progress to other statuses. Please also note that your JIRA administrator may have customised the available statuses to suit your organisation.

Open: This issue is in the initial 'Open' state, ready for the assignee to start work on it.
In Progress: This issue is being actively worked on at the moment by the assignee.
Resolved: A Resolution has been identified or implemented, and this issue is awaiting verification by the reporter. From here, issues are either 'Reopened' or are 'Closed'.
Reopened: This issue was once 'Resolved' or 'Closed', but is now being re-examined. (For example, an issue with a Resolution of 'Cannot Reproduce' is Reopened when more information becomes available and the issue becomes reproducible.) From here, issues are either marked In Progress, Resolved or Closed.
Closed: This issue is complete.

Resolution

An issue can be resolved in many ways, only one of them being 'Fixed'. The default resolutions are listed below; note that your JIRA administrator may have customised these to suit your organisation.

Fixed: A fix for this issue has been implemented.
Won't Fix: This issue will not be fixed, e.g. it may no longer be relevant.
Duplicate: This issue is a duplicate of an existing issue. Note: it is recommended you create a link to the duplicated issue.
Incomplete: There is not enough information to work on this issue.
Cannot Reproduce: This issue could not be reproduced at this time, or not enough information was available to reproduce the issue. If more information becomes available, please reopen the issue.