JIRA
Install
Admin
Use
Search JIRA documentation:

Defining New Statuses

PDF
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.

  1. Log in as a user with the 'JIRA Administrators' global permission.
  2. 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:

    Link to Administration sectionLink to Administration section

  3. Open the left-hand sub-menu titled "Issue Settings" if it is not open already and click on the link labelled "Statuses".
  4. This will bring up the View Statuses page. The page lists the existing Statuses, along with a form underneath to add a new Status.

    'Add New Status' screen
  5. 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:

    Directory view of icons dir in a JIRA webapp

    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
  6. 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.