Issue statuses

A status is an issue attribute that reflects the current state of the issue completion process, For example: "Open", "In progress", "Testing", and "Closed".

For each issue type in a queue workflow, you can define their own set of statuses and transitions between them. The queue owner and users granted permission to access the queue settings can edit statuses in queue workflows.

You can find a list of available statuses in the Tracker settings. You can use these statuses in any workflows. If you don't find a suitable status among the default statuses, an administrator can create a new status. You'll see the new status in the main list, and other users can start using it in their workflows.

Setting up statuses in the workflow editor

You can set up statuses within a workflow using the workflow visual editor. To open the workflow editor:

  1. In the left-hand panel, click  Queues and select a queue.

  2. In the top right corner of the queue page, click  Queue settings.

  3. Go to the Workflows tab and click the name of the workflow where you want to edit statuses.
    The workflow visual editor will open.

  4. To set up a status, select it in the workflow diagram to open the status settings panel.

    You can also add new statuses to the diagram.

Workflow start

Workflow start is the initial status of a newly created issue. In the workflow visual editor, the status being the workflow start is indicated with a flag indicator.

To make a status the workflow's starting point, select it in the diagram and click in the top right corner on the right-hand panel.

A workflow must have a status that starts the workflow. Statuses of any type can act as the workflow start.

Status types

You can define a status type within a workflow. Statuses of the same type all have the same color. Issues with the Completed and Canceled status are considered closed: they appear with a crossed out key in the queue.

To set a status type, choose it in the diagram and select a value in the Status type field on the right-hand panel:

  • : Issue has been created but is not in progress yet.
  • : Issue is in progress.
  • : Work on the issue is suspended.
  • : Issue has been completed and closed.
  • : Issue has not been not completed and is closed.

Status update after adding a comment

The Changing the status when commenting setting allows updating the status after a comment is added to an issue. It is useful in linear processes, e.g., for the support team.

  1. In the diagram, select the status from which the issue must transition when a comment is added to it.

  2. Click Changing the status when commenting on the right-hand panel.

  3. Select the target status from the list that the issue should change to after adding a comment. The list contains transitions for the status you are setting up, which have been added to the workflow diagram. Sample transitions in the list include:

    • To the previous status: Issue will switch back to its previous status.
    • Close transition: Issue will switch to the Completed status.
    • Need info transition: Issue will switch to the Paused status.
    • Reopen transition: Issue will switch to the Initial status.

  4. If necessary, enable the Set assignee from previous status and Only if comment was left by assignee options.

  5. Click Save.

Transitions between statuses

For a workflow to run properly, make sure to set up transitions between statuses.

To set up a status transition:

  1. Select a status in the diagram, then go to Transitions and click Add on the right-hand panel.

    The Source status field will show the source status. Fill in the New status field with the target status that you can choose from the list. The list contains statuses which have been added to the workflow diagram.

  2. Name: This field is for the name of the button in the Tracker interface that will switch the issue to this status. The same name will be used for the transition in the editor. By default, the name matches the new status in the transition; however, you can edit it. The Name in English is filled in automatically.

  3. You can configure the following for transitions:

    • Automation: Auto actions to be performed during a transition.
    • Transition conditions: Conditions under which a transition will be available.
    • Transition screen: Pop-up window where the user must fill in the respective fields to update the issue parameters.

Allowing transitions from any status

If you want to add a status that can be reached from any other status in the workflow, use the Allow transitions from any status option. This way, you won't have to manually set up transitions for each status.

  1. Select a status in the diagram.

  2. Select Allow transitions from any status on the right-hand panel, and the diagram will show the Any status meta transition for this status.

  3. To set up the Any status transition, choose it in the workflow diagram.

Copying transitions

You can apply transitions of one status to other statuses. To do this:

  1. Select a status in the diagram and click on the right-hand panel.
  2. Click  Copy transitions from this status to another or  Paste transitions from another status.
  3. In the list, select a status to insert or copy the transitions to.

Adding a status to a workflow

To add a status to a workflow:

  1. In the left-hand panel, click  Queues and select a queue.

  2. In the top right corner of the queue page, click  Queue settings.

  3. Go to the Workflows tab and click the name of the workflow you need. The workflow visual editor will open.

  4. In the top panel of the workflow visual editor, click Add status. Start typing the name of the new status and click the Create button.

  5. In the suggested list of statuses, select the one to add to the workflow.

    The most popular statuses are available in Tracker by default. If you do not see the status you need, the admin can create one.

  6. Set up the status. You can:

Creating a status

Only an administrator can create new issue statuses. Once you have created a status, you cannot delete or edit it.

You can create a new issue status on the Issue statuses page in the Tracker settings or in the workflow's visual editor in the queue.

  1. Make sure you are authorized in Yandex Tracker as an administrator.

  2. In the left-hand panel, select  Administration → Issue statuses.

  3. Click Create status.

  4. Fill in the fields as follows:

    • Name: Enter a status name in Russian.
    • Name in English: It will be generated automatically based on the Russian name.
    • Key: It will be generated automatically based on the Russian name.

  5. Click Create.

  1. In the left-hand panel, click  Queues and select a queue.

Deleting a status from a workflow

When a status is deleted, all the related status transitions are deleted, too. If you try to delete the status being the workflow start, an error occurs in the diagram, as the workflow may not exist without a starting point.

To delete a status from a workflow:

  1. In the top right corner of the queue page, click  Queue settings.

  2. Go to the Workflows tab. In the editor, open the workflow to delete the status from.

  3. Click the status to be deleted and then press Delete on the keyboard or go to the status settings and click → Remove from workflow.

Previous
Resolutions
Next
Transitions between statuses