Skip to main content

About insights for Projects

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

Who can use this feature

People with write or admin access to a project can use Insights.

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: Insights is available for the new Projects experience, you cannot use Insights with projects (classic). 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.

Insights does not track items you have archived or deleted.

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 of a stacked column chart, with a column for each iteration. Each column is divided into sections for "Bug", "Feedback", "Backend", and "UI."

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 of an example burn up chart.

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

Further reading