Chart editor guide

Chart editor guide

Chart editor guide

In this guide, we'll guide you through the steps of creating charts using Linear projects and teams as data sources.

See also these related guides:

To create your first chart, go to the Charts tab, and click Add new chart. You'll be shown the chart editor that allows creating charts from the selected data sources.

In this guide, we'll guide you through the steps of creating charts using Linear projects and teams as data sources.

See also these related guides:

To create your first chart, go to the Charts tab, and click Add new chart. You'll be shown the chart editor that allows creating charts from the selected data sources.

In this guide, we'll guide you through the steps of creating charts using Linear projects and teams as data sources.

See also these related guides:

To create your first chart, go to the Charts tab, and click Add new chart. You'll be shown the chart editor that allows creating charts from the selected data sources.

Select the chart type

You can select the chart type using the Chart type menu:

Pick a chart type

You can learn more about the available charts on the Charts Tour.

Select the chart type

You can select the chart type using the Chart type menu:

Pick a chart type

You can learn more about the available charts on the Charts Tour.

Select the data sources

In the Data sources menu, you can select one or more Teams to be used as data sources in the chart:

Select data sources

You can select multiple items from this menu by picking one, then another, and so on. The list contains the Linear teams you have imported to Screenful.

You can import more teams by selecting Data sources from the main menu:

Import data sources


Select the data sources

In the Data sources menu, you can select one or more Teams to be used as data sources in the chart:

Select data sources

You can select multiple items from this menu by picking one, then another, and so on. The list contains the Linear teams you have imported to Screenful.

You can import more teams by selecting Data sources from the main menu:

Import data sources


Select the unit for the chart

You can select the unit for the chart from the Unit menu. The default selection is Issues, which shows the counts as the number of issues:

Select unit

You can change the unit to either Estimates or Time in state:

Unit dropdown types

The selected unit is reflected in the chart as follows:

  • Issues -> Chart uses issue count as the unit (e.g. completed issues within a date range).

  • Estimates -> Chart uses estimates as the unit.

  • Time in state -> Chart shows timing data e.g. time in progress, lead time, cycle time.

Select the unit for the chart

You can select the unit for the chart from the Unit menu. The default selection is Issues, which shows the counts as the number of issues:

Select unit

You can change the unit to either Estimates or Time in state:

Unit dropdown types

The selected unit is reflected in the chart as follows:

  • Issues -> Chart uses issue count as the unit (e.g. completed issues within a date range).

  • Estimates -> Chart uses estimates as the unit.

  • Time in state -> Chart shows timing data e.g. time in progress, lead time, cycle time.

Select the metric for the chart

Once you have selected the unit for the chart, the next step is to choose the metric:

Select metric

Pay attention to this step, as picking the wrong metric can produce undesired results. Some of these metrics require a date range, while others don't. The first three metrics show the current state, and therefore, there is no date range involved:

Non-date metrics

When you select a metric that requires a date range, the date range menu appears automatically:

Date range metrics

The selected metric is reflected in the chart as below:

  • Total -> The total amount of the selected unit in the selected data sources

  • Not started & In progress -> The amount of selected unit not completed, according to the workflow settings

  • In progress -> The amount of selected unit in progress, according to the workflow settings

  • Created (within date range) -> How much of the selected unit was created within the date range

  • Completed (within date range) -> How much of the selected unit was completed within the date range

At the bottom of the menu, you have your date fields:

Custom date fields

When you select a date field as the metric, the date range menu appears. The selected date range will be applied to the selected date field and issues with the date within the selected date range are included in the chart.

Select the metric for the chart

Once you have selected the unit for the chart, the next step is to choose the metric:

Select metric

Pay attention to this step, as picking the wrong metric can produce undesired results. Some of these metrics require a date range, while others don't. The first three metrics show the current state, and therefore, there is no date range involved:

Non-date metrics

When you select a metric that requires a date range, the date range menu appears automatically:

Date range metrics

The selected metric is reflected in the chart as below:

  • Total -> The total amount of the selected unit in the selected data sources

  • Not started & In progress -> The amount of selected unit not completed, according to the workflow settings

  • In progress -> The amount of selected unit in progress, according to the workflow settings

  • Created (within date range) -> How much of the selected unit was created within the date range

  • Completed (within date range) -> How much of the selected unit was completed within the date range

At the bottom of the menu, you have your date fields:

Custom date fields

When you select a date field as the metric, the date range menu appears. The selected date range will be applied to the selected date field and issues with the date within the selected date range are included in the chart.

Select grouping

If the selected chart type supports grouping, the Group by menu allows the selection of the grouping criteria:

Group by issue properties

At the bottom you'll have the time-based grouping options: day, week, month, and quarter:

Time-based grouping

Select grouping

If the selected chart type supports grouping, the Group by menu allows the selection of the grouping criteria:

Group by issue properties

At the bottom you'll have the time-based grouping options: day, week, month, and quarter:

Time-based grouping