Skip to main content

About insights for Projects

You can view and customize charts that are built from your project's data.

Historical charts are available with GitHub Team and GitHub Enterprise Cloud for organizations. You can save unlimited charts in private projects with GitHub Team and GitHub Enterprise Cloud for organizations and GitHub Pro for users. Users and organizations using a public project can also save unlimited charts. Users and organizations using GitHub Free or a legacy plan can save two charts in private projects. For more information, see "GitHub's products."

Note: Historical charts are currently available as a feature preview for organizations using GitHub Team and are generally available for organizations using GitHub Enterprise Cloud.

You can use insights for Projects to view, create, and customize charts that use the items added to your project as their source data. You can apply filters to the default chart and also create your own charts. When you create a chart, you set the filters, chart type, the information displayed, and the chart is available to anyone that can view the project. You can generate two types of chart: current charts and historical charts.

About current charts

You can create current charts to visualize your project items. For example, you can create charts to show how many items are assigned to each individual, or how many issues are assigned to each upcoming iteration.

You can also use filters to manipulate the data used to build your chart. For example, you can create a chart showing how much upcoming work you have, but limit those results to particular labels or assignees. For more information, see "Filtering projects."

Screenshot showing an stacked column chart showing item types for each iteration

For more information, see "Creating charts."

About historical charts

Historical charts are time-based charts that allow you to view your project's trends and progress. You can view the number of items, grouped by status and other fields, over time.

The default "Burn up" chart shows item status over time, allowing you to visualize progress and spot patterns over time.

Screenshot showing an example of the default burn up chart for the current iteration

To create a historical chart, set your chart's X-axis to "Time." For more information, see "Creating charts" and "Configuring charts."

Further reading