Add new status and steps to Jira server workflows

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible


Add a new status to workflow and how to edit steps name for workflow.


In an advertising firm, the whole project flow will be involving repetitively revising and reviewing on the proposed idea before the project planning get finalized. Thus we will need to define the status "Reviewing" in this case to add it as a part of the whole project flow.


(warning) Note: it is important to note that the solution can only be implemented by a Jira user who was granted the Jira Administrator global permission. An administrator of a specific Jira project will not be able to implement this solution without being granted the Jira Administrator permission.

Define A New Status

  1. Log in as a user with Jira Administrators permission.
  2. Go to Statuses page by choosing Cog Icon > Issues > Find  Statuses  under Issue Attributes category at the left.
  3. Click at Add Status then specify the name, description and the category for the status you want to add.

Add the new Status to Workflow

  1. Go to Workflows page by choosing Cog Icon  > Issues > Find Workflows under Workflows category at the left.
  2. Click at the Edit link at the workflow that you would like to add the status in.
  3. Click at Add Status the pre defined Statuses will be listed out. Select Revising and Add

  4. Click at any node of the Reviewing status and drag it to a node on the Revising Status to create transition. The Add Transition Screen will prompt out as showed below :

  5. After you are done with editing on your workflow, remember to publish draft or activate your workflow.

Adding a Steps in Text Mode

  1. In the configuration above we are editing workflow in Diagram Mode where we can only add Statuses and by default the Steps name will be the same as the status added.
  2. Text mode is a more advance way to edit workflow where you can work directly with steps.
  3. Switch the workflow editing mode from Diagram to Text. You will find the Add New Step form appears below.

  4. Then you can specify a different Step Name for the Status that you would like to add using text mode editing.

Editing / Delete Steps in Text Mode

  1. Click at the Edit link at the steps that you want to edit to edit the Step Name and Status that you have just configured.

  2. The Delete Step link only appear when there's no incoming transition linked to the step or if it only has Global Transitions. Click at the Delete Step link to delete the step added.

Do more with Jira

Discover even more ways to configure workflows with top workflow apps on the Atlassian Marketplace.


Add a new status to workflow and how to edit steps name for workflow.

Last modified on Jun 10, 2022

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.