JIRA 7 has landed! Are you an existing JIRA user with questions about upgrading? Visit the Migration Hub for information about upgrading to new JIRA applications

Skip to end of metadata
Go to start of metadata

This page is still under construction.

Common Workflow Configuration Mistakes

  • Workflow action missing.
    Conditions control who can perform a transition, and under what circumstances. If a condition fails, the user won't see the transition link on the View Issue page. See Transition Conditions.
  • Workflow action results in permission error.
    Validators check that any user-supplied input is valid before performing the transition. For example, a validator can be used to ensure that the comment entered by a user on the transition's screen meets a certain criteria. If a validator 'fails', the Post Functions of the transition will not be executed and the issue will not progress to the destination step of the transition. See Transition Validator.
  • Cannot edit or delete steps within a workflow.

    There are limitations when trying to edit the draft of an Active Workflow as mentioned here:

    Please note that the following limitations apply when editing an active workflow:

    • Existing workflow steps cannot be deleted.
    • The associated Status for an existing step cannot be edited.
    • If an existing step has no outgoing transitions, it can't have any new outgoing transitions added.
    • Step IDs for existing steps cannot be changed.

    If you wish to make any of the modifications listed above, then you will need to copy the workflow (see 'Creating a Workflow'), modify the copy and then activate it. Please note, this method will be significantly slower than editing an active workflow, particularly for large instances of JIRA.

  • Associating Workflow with a project/issue > Workflow hierarchy

    Once you have created a new workflow or modified an inactive workflow, you will need to activate it. To activate a workflow, you need to:

    1. Create a Workflow Scheme that references your workflow, and (optionally) associate it with the relevant issue type(s).
    2. Associate the Workflow Scheme with the relevant project(s).
    Click to see the larger image:
  • Step Properties
    • Workflow Properties
      Using step properties

      You can use step properties to prevent issues from being edited when they are in a particular workflow step(s). For example, in the default JIRA workflow, issues in the 'Closed' step/status cannot be edited, even by users who have the 'Edit Issue' permission. Note that issues which cannot be edited cannot be updated using Bulk Edit either.

      To stop issues from being editable in a particular step, set the 'jira.issue.editable' property of the step to 'false' as follows:

      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.
      3. In the left-hand navigation panel, under 'Global Settings', click the 'Workflows' link.
      4. The 'View Workflows' page will be displayed as shown in 'Creating a workflow' above. Click the 'Steps' link next to the workflow whose step you wish to make uneditable.
      5. The 'View Workflow Steps' page will be displayed, showing the steps that make up the workflow.
      6. Click the 'View Properties' link that corresponds to the relevant step.
      7. The 'View Workflow Step Properties' page will be displayed, showing the step's existing properties (if any). The 'Add New Property' form appears below the list of steps. (Note: this form will only be shown if the workflow is inactive or you are editing an active workflow. )
      8. In the 'Property Key' field, type: jira.issue.editable .
      9. In the 'Property Value' field, type: false .
      10. Click the 'Add' button.

Knowledge Base Articles

Check known Workflow issues from our Knowledge Base
  • No labels
Page: Closing an Issue Results in 'Column 'ID' cannot be null' Error Page: Clicking on View Workflow in issue view results in pop-up error Page: 'Found a workflow in the request parameters, but there is no workflowMode' Error when Editing Workflow Page: JIRA throws NullPointerException using Imported Workflow Due to Missing Linked Status Page: 'XSRF white list failure' When Editing Workflows Page: Available Workflow Actions do not Match Workflow Transitions Page: Cannot Create Issues due to 'Could not load validator' class Errors Page: Cannot Perform Bulk Change Operations Page: Editing Workflow Results in HTTP Status 404 Page: Exception When Viewing 'Workflow Schemes' Via Project Administration Page: JIRA Throws Missing Available Workflow Actions Page: New Workflow Screen will not Save Page: JIRA Shows Multiple UNRESOLVED Statuses Page: Workflow Transition Fails Due to 'Error Retrieving Originating Step' Page: NullPointerException in 'com.atlassian.jira.issue.managers.DefaultIssueManager.notifyTrackbacks' Error During Issue Creation Due to Invalid Workflow Page: SysBliss Workflow Designer fails to enable Page: NullPointerException after importing workflow XML Page: How to Capture the Initial Resolution Date Page: 'Incorrect syntax near the keyword DEFAULT Error is Thrown When Moving or Cloning Issues Page: Workflow error: Cannot find Screen with id 'xxxxx' Page: Missing class for post-function on workflow transition Page: NullPointerException when the name of the project workflow has trailing space(s) in the jiraworkflows table or workflowschemeentity table Page: Cannot Delete Workflow Step from Draft Workflow Page: Issues Become Resolved Silently Page: Issues can be transitioned by all users, even though they don't have permission Page: Issue is not updated by Post Function Page: Exceptions occur in Workflow Designer / View Workflow using Java 1.7 Page: Workflow designer not showing up Page: How to remove optional post functions from the initial transition in a workflow Page: The 'Update Issue Field' Post-Function Doesn't work when Creating Issues after Upgrading to JIRA 6 Page: Adjusting the Size of JIRA Workflow Editor Window Page: Unable to Transition Workflow due to Duplicate entry error Page: Required Field warnings do not appear when submitting a transition without required information Page: Can't get Assign to Current User post-function to work on the Create Issue transition Page: Issue Security Level not set when the function added in Create Issue post-function Page: Transition not appearing for Issue Type Test when using Zephyr Page: Error while editing Workflow Scheme - The entity name must immediately follow the '&' in the entity reference. Page: Post-function on Create Issue transition appears to not work Page: Workflow Step Properties blocks transition actions Page: NullPointerException when creating an issue Page: 500 Error Page when Viewing Statuses