Jira is getting a fresh new look and navigation

We’re in the process of rolling out these changes and the documentation may not match your experience. Bear with us while we update it to reflect the new changes. More about navigating the new Jira

Backfill GitHub data in Jira

Backfilling refers to the process of importing historical data from your GitHub organization into your software project. This way, you can view previous data alongside current work, and keep both sources in sync.

When you connect GitHub, Jira automatically imports six months of history. The following information is imported:

  • All pull requests - the Jira work item key needs to be in the title or the description of the pull request, or in the name of the source branch.

  • Builds and deployments - if Jira work item keys are included in commit messages, branch names, or pull requests that are part of a workflow or deployment. Find out more about linking builds and deployments to Jira

  • Commits containing Jira work item keys - only the latest 50 commits from non-default branches will be backfilled. Any unreachable commits (like commits from deleted branches) are excluded.

  • Branches - as long as the work item key is in:

    • the branch name, or

    • the title of the latest pull request associated with the branch, or

    • the last commit message of the branch.

Manually backfill GitHub data

If you want to import more than six months of historical GitHub data:

This process requires Jira admin permissions.

  1. Select Apps, then Manage your apps.

  2. Select GitHub for Jira in the sidebar.

  3. Select settings () for your GitHub organization, then Continue backfill.

  4. Select the date you want to start importing history from, then Backfill data. By default, the manual importation process adds data in addition to what’s already been imported. If you want to overwrite all existing historical data, select the checkbox next to Restart the backfill.

Still need help?

The Atlassian Community is here for you.