Defining New Statuses
| 
PDF |
Statuses are used to represent the position of the issue in its workflow. A workflow
represents a business process, represented as a set of stages that an issue goes through to reach a final stage
(or one of the final stages). Each stage in the workflow (called a workflow step) is linked to an issue
status, and an issue status can be linked to only one workflow step in a given workflow.
JIRA ships with a set of default statuses that are used by the default workflow.
In JIRA Enterprise and Professional editions you can add your own statuses and
customise the workflow. In Standard edition, workflow is not
customisable and you cannot add new Statuses — but in all editions you can change the names, descriptions and
icons of existing Statuses.
- Log in as a user with the 'JIRA Administrators' global permission.
-
Bring up the administration page by clicking either the 'Administration' link on the top bar or the title of the
Administration box on the dashboard:


- Open the left-hand sub-menu titled "Issue Settings" if it is not open already and click on the link labelled "Statuses".
-
This will bring up the View Statuses page. The page lists the existing Statuses, along with a form
underneath to add a new Status.
- To add a new Status, fill in the Add New Status form. For the name put a short phrase that best describes
your new Status. For the description, put a sentence or two to describe what stage this Status represents.
For the Icon URL you need to supply the path of a 16 by 16 image that has been placed somewhere inside JIRA's
opened .WAR. We suggest you place it in /images/icons:

JIRA ships with a number of images that can be used as status icons. These images are located in the /images/icons directory inside the JIRA .war and include:
- status_assigned.gif
- status_closed.gif
- status_document.gif
- status_down.gif
- status_email.gif
- status_generic.gif
- status_information.gif
- status_inprogress.gif
- status_invisible.gif
- status_needinfo.gif
- status_open.gif
- status_reopened.gif
- status_resolved.gif
- status_trash.gif
- status_unassigned.gif
- status_up.gif
- status_visible.gif
- The View Statuses table can be used to edit and delete Statuses. Please note that only statuses that are not used in any workflow can be deleted.