Gadget Title

Choose what to display in the title bar of the gadget.

Board

Choose the Scrum board of your team.

Display the chart for the last ? sprints

Specify the number of previous sprints to be displayed in the chart, starting from the most recent.

Calculate average velocity based on last ? sprints

Specify the number of previous sprints to be used when calculating the average velocity. Velocity is calculated as the average of the total SPs done in each of these sprints.

Calculate by

Specify on which criteria the calculation to be performed. You can choose between:

• Story Points - the default value, use this if the issues are estimated in Story Points. If the issues are from team-managed projects (aka next-gen projects), select Story Point Estimate instead.

• Original Time Estimate - use this if you use time estimates; calculation will be done in hours.

• Time Remaining & Time Spent - use this option if you use time estimates and your team logs the worked time on a daily basis; calculation will be done in hours. The Initial Scope will be calculated as the sum of the Time Spent and Time Remaining of all the issues at the time when the sprint was started. The Final Scope will be calculated as the sum of the Time Spent and Time Remaining of all the issues at the end of the sprint. Completed is calculated as the sum of Time Spent of all the issues from the sprint, plus the sum of Time Remaining of all the issues from the sprint that were done.
  If you check Ignore the time logged before the start of the sprint, the calculation will be based only on the work logged during the sprint as it follows: The Initial Scope will be calculated as the sum of Time Remaining of all the issues at the time when the sprint was started. The Final Scope will be calculated as the sum of the Time Spent during the sprint and Time Remaining of all the issues at the end of the sprint. Completed is calculated as the sum of Time Spent during sprint of all the issues from the sprint.

• Issue Count - use this if you want the calculation to be done by number of issues

• Other numerical custom field defined in your Jira instance - pickup the numerical custom field that you use to track or to estimate the issues.

Series to Display

Choose what series to display in the chart. You can select one or more options:
Initial Scope - represents the scope at the start of the sprint (the team commitment).
Final Scope - represents the scope at the end of the sprint, after the eventual scope changes. This helps you determine if your team tends to change the sprint scope and how much.
Completed - represents the total amount of work done in that sprint.
Average Velocity - The average velocity calculated as the average of the work done in the last sprints, according to the gadget settings.
Scope change - represents the scope change of the sprint, calculated as the difference between Final Scope and Initial Scope.
Scope change absolute - represents the scope change of the sprint as absolute value, calculated as the sum of Added and Removed.
Added - indicates the amount of work added to the scope after the sprint was started.
Removed - indicates the amount of work removed from the scope after the sprint was started.
% Scope Change - indicates the percent of scope change relative to the Initial Scope.
% Scope Change Absolute - indicates the percent of scope change absolute relative to the Initial Scope.
% Added - indicates the percent of work added relative to the Initial Scope.
% Removed - indicates the percent of work removed relative to the Initial Scope.
% Completed - indicates the percent of work completed relative to the Initial or Final scope, depending on what you selected at Calculate %Completed relative to ? scope.

Count also the sub-tasks and their estimate

Check this option if you want the gadget to consider the sub-tasks from the filter and their estimate when doing the calculation.

"Done" means

Specify how the gadget should consider issues as done when determining the work completed.

The default option is Issue is in last column of the selected board, which means that issues are considered done when they reach the last column of the board or, more exactly, a status that is mapped to the last board column.

Choose Issue is in one of these statuses, and then select one or more workflow statuses, to consider issues as done when they reach one of these custom statuses.

Options for including sprints

The gadget displays the closed sprints, but you can choose to include only certain sprints or the active sprints. Check Only sprints whose names contain... and enter the text to match if you want only specific sprints to be displayed by the chart. This option is useful when you want to filter out some of the board's sprints.
Also, you can check Only sprints completed between... and enter the dates of the time interval if you want to display only the sprints that were completed (closed) in that time interval. This option is useful when you want to see the velocity for past sprints. For example, the sprints from the previous year.
Check Include also the active sprint(s) if you want to display the active sprints (if any) along with the closed sprints.

Show legend

Check this if you want the chart legend to be displayed.

Tilted labels for x-axis (avoid overlapping)

Check this to avoid overlapping of the x-axis labels.

Show data table

Check this option if you want a data table to be displayed along with the chart. The Data tab displays all the sprints along with the issues that affected their velocity. The issues that had zeros on all the columns are not displayed.

Display all series as lines

Check this option if you want the chart to have all the series displayed as lines (instead of bars).

Display horizontal gridlines

Check this option if you want the chart to display gridlines for the vertical axis.

Refresh cached data at next display

This gadget uses data caching for faster display, which means that some data resulted after processing are saved and reused next time the gadget is loaded. If you check it, the cache of the gadget will be deleted and recreated at the next reload. This setting is not persistent.

Automatically assign colors

Check this if you want the chart to automatically assign colors for the series.

Custom colors

Select any custom color you want the series to be displayed on by either entering the color's hexadecimal code or picking a color.

You can also use the Copy and Import buttons to copy and import the color configuration to gadgets of the same type.