Review your workflow

Review your workflow

The workflow settings specify when the work is started and when it's completed. It is used in calculating metrics such as lead or cycle time of issues and pull requests, or how long they stay in a specific workflow state.

The workflow settings specify when the work is started and when it's completed. It is used in calculating metrics such as lead or cycle time of issues and pull requests, or how long they stay in a specific workflow state.

The workflow settings specify when the work is started and when it's completed. It is used in calculating metrics such as lead or cycle time of issues and pull requests, or how long they stay in a specific workflow state.

Accessing the workflow settings

You can access the workflow settings by selecting Data Mapping from the main menu.

The workflow settings show the automatically detected workflow on your board. To adjust the mapping, drag & drop the states between the three boxes: 

  • Not started = Work to be done (your backlog)

  • In progress = Work started but not completed

  • Done = Completed work



Workflow for GitHub repositories

The default workflow for repositories is based on issue and pull request statuses as below:

Here’s how it affects the calculation of the Timing metrics:

  • Lead time starts when an issue is created

  • Cycle time starts when the issue is assigned to a person, or when pull request is opened

  • Lead & cycle time is stopped when the issue is closed, or the pull request merged

Workflow for GitHub Projects

When importing a GitHub project as a data source, the workflow is based on the board columns. The columns on your board are automatically mapped to either Not started, In progress, or Done. This information is used when calculating the Timing metrics.

If the suggested mapping looks correct, you can accept it by clicking Looks good to me. To make changes, click Adjust mapping. The boxes become editable, and you can drag & drop items between them.

Auto-mapping new workflow states

When using GitHub projects, you may add new columns to your board. By default, new columns are automatically mapped to either Not started, In progress, or Done using AI. Alternatively, you can force the mapping of new states by selecting one of the other options from the menu.

Frame 34.png

Related articles