YouTrack Server 2024.2 Help

State Transition

This report tracks the change in value for a custom field within a specified time frame. For example, it shows how many issues were fixed by each developer in the past month, or shows who reported the most issues that ended up with the state Won't fix.

Unlike the Verified Distribution and Reopened Distribution reports, you can configure this report to track changes in value for any field that stores an enumerated type. For example, you can generate a report that tracks changes in the Priority field and show issues that escalated from minor or normal priority to major or critical.


Use the following settings to configure this report.



Report name

Assigns the report a name.


Filters the report to display issues from specific projects. The list is limited to projects in which you have the Read Project Basic permission.

Issue filter

Filters the report to display issues that are returned by the specified query. The input field provides the same syntax and auto-completion options that are available in the search box.


Filters the report to show only issues that transitioned from the values that are selected in the From setting to the values that are selected in the To setting within the selected time frame.

Automatically Recalculate

Configures periodic recalculation for your report.

  • If you select Never, automatic recalculation is disabled. The report can only be recalculated manually.

  • If you select any of the other options, YouTrack checks if the selected time period has elapsed when you open the report. If yes, the report is recalculated. You can manually recalculate reports with automatic recalculation enabled at any time.


Sets which field is analyzed for changes in value. The selection is limited to fields that store enumerated types.


Selects the values in the field that are considered for the initial state of the transition.


Selects the values in the field that are considered for the end state of the transition.

Group by

Determines which custom field or issue attribute is used to group values on the report. For example, you can group issues by assignee or by project.

Sort order

Sorts the values in the attribute or custom field that is used for the Group by setting. By default, items are sorted by count in descending order. This shows the value that has the highest distribution at the top of the list.

The natural sort order corresponds to the order in which values appear in the set of values for the selected field or attribute. For example, the natural sort order for the updated attribute is chronological by date. The natural sort order for the updater attribute is alphabetical by full name.


Determines which type of chart is used to display data in the report. This report can be presented as a bar chart or a pie chart.

Can view and use

Sets the visibility for the report. By default, the report is visible to its owner only.

To share the report with other users, select a group or project team from the list.

Can edit

Determines who has permission to view and edit the report settings.

To let other users update the report settings, select a group or project team from the list.


A report with the following settings displays the number of issues that transitioned from the Submitted and Open states to the Fixed state in the last month.




AppCode, dotCover, dotMemory, dotPeek, dotTrace, IntelliJ IDEA, Kotlin, PhpStorm, PyCharm, ReSharper, Ruby, WebStorm _ IntelliJ Web, YouTrack






Open, Submitted



Group by


State transition bar

Here's the same report presented as a pie chart:

State transition pie
Last modified: 19 July 2024