How to change the status on a Workflow in Jira

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

Context

This KB is focused on those cases that need to update the status of your workflow as you may face one of the next scenarios:

  • You may have duplicated or similar statuses.
  • You have created a new status, and want to link this status to the step that is already in place.

Steps:

  1. Workflow

    1. Go to Administration > Issues > workflows
    2. Select the workflow you want to update and click on copy.
      1. It will pop up a screen where you can update the new name of the workflow.
      2. (info) Suggested to keep the same name, but adding the postfix of the version like: "Workflow_v2"
    3. When you do click on copy,  it will show the Workflow edit screen.
      1. On which you can select the step you want to update the status and click Edit.
    4. the Result is a Workflow with the status updated:
    5. Once updated, the change will be automatically saved.
      1. (info) The Inactive workflows will be affected by any update, it does not have the need to publish it.
    6. To Check your new workflow you may need to go to the Inactive section, at the bottom of the Workflows page.
  2. Workflow scheme

    1. Go to Administration > Issues > workflows schemes
    2. Select the Workflow scheme that your workflow is being assigned.
    3. Then click on copy and automatically creates a copy in the Inactive Section.
    4. Then click on Edit on the Copy of the workflow schema we are going to update.
      1. Edit the name and the description of the workflow scheme, so it's easy to identify.
        1. (info) Suggestion as the workflow, add the version after the name so you can identify it easily.
      2. Add the Workflow you created, by clicking Add Workflow > Add Existing
      3. You need to select the Workflow created
      4. Then Select the Issue types that the old Workflow was assigned, this is to replace it with the new Workflow.
      5. The result is a Workflow schema setup with the new workflow.
  3. Project Settings

    1. Once the new workflow is set with the new status, and the new workflow schema has the Issue types assigned to the new workflow, we can proceed to switch the Workflow Schema.
    2. Go to the "Project" > Project Settings > workflows
    3. Click on Switch Scheme

    4. Associate the Workflows scheme:
      1. Select the Scheme from the drop-down.
      2. Associate the current status on the old workflow to the one in the new workflow.
      3. The system will migrate the status from the old workflow scheme to the new one.
    5. The result is a project with the proper workflow scheme update with the proper workflow.


These steps are suggested as you are modifying a new Workflow or new workflow scheme in case of any trouble you can do a rollback to the old workflow scheme.


Last modified on Jun 22, 2023

Was this helpful?

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