Documentation for JIRA 4.4. Documentation for other versions of JIRA is available too.

Skip to end of metadata
Go to start of metadata
  Why would I do this? (click to expand)

Depending on how your organisation is using JIRA, you might need to add a new 'Status' , i.e. a new step in the issue 'workflow'.
For example, if you are using JIRA to track purchase orders, you might add a new Status called 'Purchase Approved' .

  How do I do this? (click to expand)

To add a new Status called 'Purchase Approved', and create a new workflow that has an extra step between 'Open' and 'In Progress':

  1. Click 'Administration' in the top navigation bar.
  2. Click 'Statuses' in the left navigation column (under 'Issue Settings').
  3. In the 'Name' field, type 'Purchase Approved'. Then click the 'Add' button'. (For more about adding Statuses, and icons, please see the documentation.)
  4. Click 'Workflows' in the left navigation column.
  5. Click the 'Copy' link next to 'jira (Read-only System Workflow)'.
  6. In the 'Workflow Name' field, type 'Purchase Order Workflow'. Then click the 'Copy' button'. (For more about Workflow, please see the documentation.)
  7. Click the 'Steps' link next to 'Purchase Order Workflow'.
  8. In the 'Add New Step' form:
    1. in the 'Name' field, type 'Purchase Approved'.
    2. in the 'Linked Status' field, select 'Purchase Approved'.
    3. click the 'Add' button.
  9. Click the 'Add Transition' link next to 'Open':
    1. in the 'Name' field, type 'Approve Purchase'.
    2. in the 'Destination Step' field, select 'Purchase Approved'.
    3. click the 'Add' button.
  10. Click the 'Add Transition' link next to 'Purchase Approved':
    1. in the 'Name' field, type 'Start Progress'.
    2. in the 'Destination Step' field, select 'In Progress'.
    3. click the 'Add' button.
  11. Click the 'Delete Transitions' link next to 'Open'. Select 'Start Progress' and click the 'Delete' button.
  12. Click 'Workflow Schemes' in the left navigation column (under 'Schemes'). Then click 'Add Workflow Scheme'.
  13. In the 'Name' field, type 'Purchase Order Workflow Scheme'. In the 'Default Screen' field, select 'Purchase Order Screen'. Then click the 'Add' button'. (For more about Workflow Schemes, please see the documentation.)
  14. Click the 'Workflows' link next to 'Purchase Order Workflow Scheme', click 'Assign Workflow' and select 'Purchase Order Workflow'. Then click the 'Add' button.
  15. Click 'Projects' in the left navigation column. Then in the 'Name' column, click 'Purchase Orders'. The project details will be displayed.
  16. Click the 'Select' link next to the 'Workflow Scheme' field, select 'Purchase Order Workflow Scheme' and click the 'Associate' button.

To test what you have done, create an issue in the 'Purchase Orders' project. After you save the issue, the left column should contain a link called 'Approve Purchase', but not a link called 'Start Progress'.

Note: you may also want to watch the video on customising JIRA Workflow.

  • No labels