How To Add A Status To Jira

Atlassian’s JIRA, a project management program, offers a versatile solution for monitoring and overseeing software development projects. One crucial component of JIRA is its ability to adapt to different workflows, allowing teams to personalize the program to fit their unique requirements. A key aspect of this capability is the use of statuses, which indicate an issue’s progress in the workflow. This article will walk you through the steps of incorporating a new status into JIRA.

Understanding JIRA Statuses

In JIRA, a status represents the stage of an issue within a workflow. A workflow is the pathway that an issue follows from creation to completion, and a status indicates an issue’s position within that pathway. For instance, typical statuses might be ‘To Do’, ‘In Progress’, or ‘Done’, with each status indicating a phase of the project’s life-cycle.

Adding a Status in JIRA

Adding a status in JIRA can be done in a few simple steps. Before you start, ensure that you have the necessary administrative permissions to make changes to your JIRA instance. Here’s a step-by-step guide:

Step 1: Access JIRA Administration

First, click on the gear icon located on the top right corner of your JIRA dashboard. This will open up a menu where you can find the ‘JIRA Administration‘ link. Click on this link to access JIRA’s administrative settings.

Step 2: Navigate to Issues

In the JIRA Administration page, look for the ‘Issues‘ link in the menu on the left side and click on it.

Step 3: Access Statuses

On the Issues page, scroll down to find the ‘Statuses‘ link under the ‘Issue Attributes’ section. Click on this link to access the page where you can view, add, edit, or delete statuses.

Step 4: Add Status

On the Statuses page, you’ll see a ‘Add Status‘ button near the right-hand corner on top. Click this button to open a dialog box where you can add a new status.

Step 5: Define Your Status

In the dialog box, you’ll have to provide a name and a description for your new status. Once done, click on the ‘Add‘ button to create your status.

Name: "Review"<br>
Description: "The issue is being reviewed."<br>

Step 6: Associate the Status with Workflow

After creating the status, you will need to associate it with a workflow. To do this, go to ‘Workflows‘ under the ‘Issues’ section in ‘JIRA Administration’, and then edit the desired workflow to incorporate the new status.

You have now successfully added a new status to your JIRA workflow!


Adding a custom status to your JIRA workflow can streamline your project management process, making it easier to track issues and improve productivity. By following the steps outlined in this guide, you’ll be able to customize your JIRA instance to better reflect your team’s unique project life-cycle and workflows.