Defining status field values

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 applications ships with a set of default statuses that are used by the default workflow. You can add your own statuses and customize the workflow. You can also re-order existing statuses, as well as change their names, descriptions and lozenges.

On this page:

For all of the following procedures, you must be logged in as a user with the JIRA Administrators global permission.

Defining a new status

  1. Choose > Issues
  2. Select Statuses to open the 'Statuses' page.
  3. Click Add Status and complete the 'Add Status' form:
    • Name — specify a short phrase that best describes your new status.
    • Description — add a sentence or two to describe what workflow step this status represents.
    • Category —  choose a category that this status will be grouped into: 'To Do' (blue), 'In Progress' (yellow) or 'Done' (green). Categories help you identify where issues are in their lifecycle, particularly in places where a large number of issues are rolled up, e.g. Version Details page, Sprint Health Gadget. The category is also used to map statuses to columns in JIRA Software , when creating a new board for an existing project.

Next steps:

Now you will need to associate your new status with a workflow 'step'. See Working with workflows.

Re-ordering statuses

You may want to change the order of statuses in JIRA in line with a particular workflow or to highlight key statuses. The order of statuses is reflected on screens (or parts of the screen) in JIRA, where issues are listed or grouped by status. These include the issues summary for a project, search results (when status is one of the columns), and a number of gadgets, like the Issue Statistics gadget (where the Statistic Type is 'Status').

  1. Navigate to the 'Statuses' page (described in the 'Defining a new status' section above).
  2. Use the up and down arrows in the Order column to re-order individual statuses.

Deleting a status

You can only delete statuses that not are being used in workflows, i.e. inactive statuses. 

  1. Navigate to the 'Statuses' page (described in the 'Defining a new status' section above).
  2. Click Delete for the status that you want to delete.

Was this helpful?

Thanks for your feedback!

Why was this unhelpful?

Have a question about this article?

See questions about this article

Powered by Confluence and Scroll Viewport