Private equity and portfolios
Jira and GitHub consolidation across acquired software companies
By SourceX Editorial · Updated
Short answer
Jira consolidation after an acquisition succeeds when the engineering history stays connected: issue keys, comments, change history, commits and pull-request reviews must still point at each other after the move. Map keys, users and repositories before migrating, label each acquired company's projects, and keep the old site read-only until link checks pass.
Key takeaways
- The links between issues, commits and pull requests carry more value than any single export, so test them before and after migration.
- Project key collisions are the most common way a Jira merge breaks references in commit messages and documents.
- CSV exports help with counts and spot checks but are not built to carry full change history.
- Label every migrated project and repository with the acquired company it came from.
- Cancel the old Atlassian site or delete the old GitHub organization last, because vendor deletion clocks start then.
What breaks when acquired engineering tools are merged?#
Jira and GitHub consolidation after an acquisition most often breaks the connections between records, not the records themselves. Issues still arrive in the new site and repositories still clone, but commit messages point at issue keys that changed, migrated comments lose their authors, and remote links point at a site that is about to be deleted.
Those connections are what make engineering history useful: an issue linked to the commits that fixed it, the pull request where the fix was reviewed and the release it shipped in. A portfolio CTO consolidating several acquired companies is really deciding whether that chain survives the move.
Three consolidation patterns and their link risk#
The three consolidation patterns for acquired engineering tools are federated, grouped and fully merged, and each carries a different risk to the links between issues, commits and reviews. Software groups usually choose by weighing license savings and shared workflows against migration effort.
| Pattern | What it looks like | Link risk | Fits when |
|---|---|---|---|
| Federated | Each company keeps its own Jira site and GitHub organization under group billing and identity | Low; nothing moves | Products stay separate and teams rarely share work |
| Grouped | One Jira site with projects per company; one GitHub enterprise with an organization per company | Moderate; Jira keys and users must be mapped | Shared tooling and reporting matter but products stay distinct |
| Fully merged | Shared Jira projects and a single GitHub organization | High; keys, workflows and repository names change | Products are being combined into one codebase |
- 01Your work records
- 02Personal details removed
- 03You approve the release
- 04Licensed to AI developers
Jira: keys, users, fields and change history#
Jira migrations hold their value when project keys, user mappings, custom fields and change history survive. Check key collisions first: if two acquired companies both used a key such as OPS, one project must take a new key, and every commit message, branch name and runbook that cites the old keys will point at the wrong issue.
Keep a mapping table of old to new keys, and store the original key in a field on each migrated issue so old references stay searchable. Map departed users to inactive accounts or placeholders instead of dropping their authorship, because who reported, reviewed and resolved an issue is part of what the history shows. List Marketplace apps per site, since test management or time tracking data follows the app vendor's own export route.
CSV is a checking tool, not a history-preserving migration route. Atlassian supports exporting up to 10,000 work items at a time with the asynchronous CSV export in Jira Cloud and recommends batching larger sets, which suits counts and spot checks. Backup and site migration routes are the ones designed to carry comments, attachments and change history; Atlassian Backup and Restore, for example, requires a Premium or Enterprise plan and keeps backups in Atlassian storage for 30 days.
GitHub: organizations, repositories and review history#
GitHub consolidation keeps review history intact when repositories move as whole units with their issues and pull requests, rather than being re-pushed as bare git history. A plain push preserves commits but leaves pull-request reviews, review comments and issue threads behind in the old organization.
Confirm which route your plans support. GitHub documents an export path that builds a migration archive from a GitHub.com organization for import into GitHub Enterprise Server; it requires owner permissions and a token with the repo and admin:org scopes, and locking a repository during migration blocks all writes. Teams moving between GitHub.com organizations should check GitHub's current documentation for their options.
Commit email addresses decide whether old commits still attribute to the right people. Collect every address each company's engineers used, including personal addresses on early commits, and map them before cutover. Where an acquired company used GitLab, note that GitLab says project exports do not include every item, and that after import or export only the latest diff version and latest pipeline in merge requests are visible.
The consolidation checklist, run per acquired company#
The consolidation checklist keeps links testable at each stage. Run it separately for each acquired company rather than once for the whole group, so a problem in one migration does not stall the others.
- Inventory sites, projects, repositories, Marketplace apps and integrations.
- Take a full backup or export of the source and record counts by project and repository.
- Resolve key collisions and build old-to-new mapping tables for keys and repository names.
- Map users and commit email addresses, including departed staff, to accounts or placeholders.
- Add a source-company field or label to every migrated project and repository.
- Freeze writes in the source, migrate, then reconnect the Jira and GitHub integration so development links resolve.
- Verify counts, then trace sample issues to their commits, pull requests and reviews.
- Keep the source read-only until verification is signed off, then decommission.
Decommissioning starts vendor deletion clocks#
Decommissioning the old Atlassian site or GitHub organization starts vendor deletion clocks, so it belongs at the end of the plan, not at the start of a cost-saving push. Atlassian says that after a cancelled subscription period ends, the site stays accessible for 15 more days and is then deactivated, with data retained for 60 days on Free, Standard, Premium or Enterprise plans before permanent deletion.
On GitHub, organization owners can restore deleted repositories within 90 days of deletion, but restoring does not bring back team permissions, and repositories in an active fork network cannot be restored directly. Treat both windows as emergency recovery, not as an archive plan.
Illustrative: three acquired companies, one engineering home#
Illustrative: a fictional vertical software holding group owns three acquired companies. One uses Jira Cloud and GitHub, one runs a self-managed Jira server with Bitbucket, and one uses GitLab with its built-in issue tracker. The portfolio CTO chooses the grouped pattern: one Jira Cloud site with projects per company and one GitHub enterprise with an organization per company.
Two companies both used the key SUP for support escalations, so one is renamed and each issue keeps its original key in a field. Bitbucket and GitLab repositories move with their pull-request and merge-request history where the tools allow, and the team records which items arrived only partly. Every project and repository carries a source-company label, and the old systems stay read-only until sampled issues trace cleanly to commits and reviews.
When the group later reviews which records could be licensed, it can show for each repository which company wrote it and which agreements apply, because that label survived the move.
Why connected histories matter after consolidation#
Connected engineering histories matter after consolidation because issue threads, commits and code reviews linked to each other show how real software problems were diagnosed and fixed, which is the kind of record AI developers look for when they license engineering work. Disconnected exports of the same material are harder to verify and less useful.
SourceX assesses such records with the SourceX Enterprise Data Value Framework, in which human-generated signal, domain expertise, recency and data cleanliness raise value, while preparation cost lowers net value; a clean consolidation keeps preparation cost down. Rights still follow the acquired entity that created the records, so the source-company label feeds the provenance section of the SourceX Evidence Packet.
Frequently asked questions
Should we consolidate before or after deciding whether to license engineering records?
Consolidate for operational reasons, but design the migration so either choice stays open. Keeping source-company labels, original issue keys and full review history costs little during migration and is hard to rebuild afterward. A later rights review can then run on the consolidated site without separating records again.
Can we merge two Jira sites without changing any issue keys?
Only if no project keys collide with each other or with projects already on the destination site. When keys collide, one project must take a new key. Store the original key on each issue and keep the mapping table, so references in commits and documents can still be resolved.
What happens to departed engineers' work after migration?
Their issues, comments and commits remain, but attribution depends on mapping. Without it, migrated comments may show a generic importer account and commits may not link to any profile. Mapping departed users to inactive accounts or placeholders preserves who did what, which matters for audits and rights reviews.
What if an acquired company used the Bitbucket Cloud issue tracker?
Check whether its issues were ever exported. Atlassian announced that the Bitbucket Cloud issue tracker and wiki would be removed on August 20, 2026, with issues exportable as a zip file or migratable to Jira. Confirm the current status with Atlassian and locate any export taken before removal.
Is bulk API extraction safe during a migration?
Plan it within the provider's rules. GitHub's terms say excessive or abusive API use can lead to suspension of API access, and its acceptable use policies prohibit excessive automated bulk activity. Prefer documented migration tools, throttle custom scripts and coordinate large jobs with the vendor.
Sources
- Atlassian states that exporting up to 10,000 work items using the asynchronous Export CSV feature from the Jira Cloud Issue Navigator is supported, and recommends splitting larger exports into JQL batches of fewer than 10,000 work items each. Source
- Atlassian Backup and Restore lets admins back up Jira and Confluence data, requires a Premium or Enterprise plan plus organization admin and app admin permissions, and stores backups in Atlassian-owned storage for 30 days. Source
- GitHub documents exporting migration data from a GitHub.com organization via the API to generate a migration archive for import into GitHub Enterprise Server; this requires owner permissions and an access token with the repo and admin:org scopes, and locking a repository during migration prevents all write access. Source
- GitLab says project export files should not be used for backups because not all items are exported, and after import or export only the latest diff version and latest pipeline in merge requests are visible. Source
- Atlassian states that after a cancelled subscription period ends, the site stays accessible for 15 more days and is then deactivated; data is retained for 60 days for Free, Standard, Premium or Enterprise plans, then permanently deleted. Source
- GitHub organization owners can restore deleted repositories within 90 days of deletion; repositories in an active fork network cannot be restored directly, and restoring does not restore team permissions. Source
- Atlassian announced that the Bitbucket Cloud issue tracker and wiki would be removed on August 20, 2026, with issues exportable as a zip file or migratable to Jira. Source
- GitHub's Terms of Service state that abuse or excessively frequent requests to GitHub via the API may result in temporary or permanent suspension of the account's API access. Source
- GitHub's Acceptable Use Policies prohibit using GitHub servers for excessive automated bulk activity that places undue burden on them. Source
Related resources
See if your company qualifies
A short company assessment. No data uploads are needed.