Skip to content

Workflows

The Workflows view allows administrators to configure which status transitions are permitted for each combination of role and tracker. Workflows control how issues move through their lifecycle, ensuring that only authorized users can transition issues to specific statuses.

Workflows editor

Workflow editor — select a role and tracker to begin

Selecting a Workflow

To edit a workflow, select a Role and a Tracker from the dropdown menus at the top of the view, then click Edit. The available roles and trackers are defined in the Roles and Trackers configuration views respectively.

  • Role: The user role this workflow applies to (e.g., User, Administrator). Select All to edit transitions for all roles simultaneously.
  • Tracker: The issue type this workflow applies to (e.g., Support Request, Issue Prioritization). Select All to edit transitions for all trackers simultaneously.

The Only display statuses that are used by this tracker checkbox filters the status matrix to show only statuses relevant to the selected tracker.

Status Transitions Tab

Workflow transitions matrix

Status transitions matrix for the User role and Support Request tracker

The Status transitions tab displays a matrix where rows represent the current status of an issue and columns represent the target status. Each cell contains a checkbox:

  • A checked cell (green) means the transition from the row status to the column status is allowed.
  • An unchecked cell (gray) means the transition is not permitted.

The special row New Issue at the bottom defines which statuses can be assigned when creating a new issue.

Additional Transition Rules

Below the main matrix, two expandable sections provide finer control:

  • Additional transitions allowed when the user is the author: Enables extra transitions when the current user created the issue.
  • Additional transitions allowed when the user is the assignee: Enables extra transitions when the current user is assigned to the issue.

Fields Permissions Tab

The Fields permissions tab controls field visibility and editability per status. For each field, administrators can set whether it is Read-only, Required, or Hidden at each workflow status, giving fine-grained control over the issue form based on where the issue is in its lifecycle.

The standard fields available for permission control include Subject, Tracker, Assignee, Category, Target version, Priority, Parent task, Start date, Due date, Estimated time, % Done, and Description. Custom fields are listed separately below the standard fields section. All fields — including Target version — can be independently set to read-only, required, or hidden for each combination of role and status.

Toolbar Actions

  • Copy: Copies the current workflow configuration to another role/tracker combination.
  • Summary: Displays a read-only overview of all configured workflows across roles and trackers.