Migrating Jira from Data Center to Cloud is a significant undertaking. Projects, issues, workflows, users, permissions, and configurations all need to be transferred successfully.
But there is one important question that deserves particular attention:
How do you verify that the complete history of your issues was preserved during migration?
Issue history is more than the current state
An issue's current status, assignee, priority, and other field values represent only its present state.
Its history tells a much larger story:
- Who changed a field, and when?
- How many times did an issue change status?
- What were its previous assignees or priorities?
- When were particular decisions reflected in issue updates?
- How did an issue evolve over months or years?
For organizations using Jira for long-running projects, operational processes, or audit purposes, this historical information can be just as important as the current issue data.
Does Jira Cloud Migration Assistant preserve issue history?
Atlassian's Jira Cloud Migration Assistant (JCMA) supports migrating issue history from Data Center to Cloud.
However, supporting history migration and independently verifying that every historical record was preserved are two different things.
Migration results can be affected by unsupported configurations, missing references, custom fields, or individual migration errors.
A successful migration is therefore not, by itself, proof that every historical change is identical to its original Data Center record.
A practical approach: export before and after migration
One way to independently verify issue history is to capture it on both sides of the migration.
Step 1: Export issue history from Data Center
Before migration, export the history of the issues included in the migration scope.
The export should contain enough information to identify and compare individual historical changes, including:
- Issue identification
- Change date and time
- Change author
- Changed field
- Previous value
- New value
Retain the exported data as a pre-migration reference.
Ideally, perform this export after the final changes to the source issues, or establish a clearly defined cutoff time so that subsequent changes are not incorrectly interpreted as migration discrepancies.
Step 2: Export issue history from Cloud
After migration, export the history of the corresponding issues from Jira Cloud.
Use the same issue population and equivalent filtering criteria.
Remember that some identifiers may differ between Data Center and Cloud. Issue keys, user identifiers, and custom field identifiers may need to be mapped before comparison.
Step 3: Compare the results
Compare the two exports to identify:
- Historical changes present in Data Center but missing from Cloud
- Differences in previous or new field values
- Missing or changed author information
- Unexpected differences in timestamps
- Differences in the number of historical changes per issue
Comparing total record counts is a useful initial check, but matching counts alone do not prove that the same historical changes were preserved.
A record-level comparison provides stronger evidence.
For large datasets, this comparison can be automated using scripts or other data-processing tools.
Step 4: Investigate discrepancies
Not every difference necessarily represents lost history.
Some differences may result from expected changes in identifiers or value representations during migration.
Others may indicate migration problems that deserve investigation.
The important point is to identify and understand these differences while the original Data Center environment is still available.
Don't overlook issue snapshots
Historical changes are only one part of migration verification.
Another useful check is to compare the values of important issue fields immediately before migration with their values after migration.
For example:
- Status
- Assignee
- Reporter
- Priority
- Resolution
- Versions
- Relevant custom fields
This helps verify that the migrated issues retain the expected state, in addition to their historical records.
A complete verification strategy can therefore examine both historical changes and issue state.
Using Issue History & Snapshots Reporter for Jira
One application that can help with historical reporting and migration verification is Issue History & Snapshots Reporter for Jira, developed by Simitech Ltd.
The application provides several relevant capabilities:
- Issue History: Search, filter, and examine historical changes across Jira issues.
- Issue Snapshots: Reconstruct issue field values at a selected point in time.
- Snapshot Comparison: Compare issue states between two dates.
- CSV and Excel Export: Export historical reports and snapshot data for independent analysis and retention.
These capabilities can support historical data verification, auditing, and reporting.
For migration verification, the important consideration is to obtain equivalent historical data from the source and destination environments, using tools appropriate to each environment.
The resulting exports can then be compared to identify potential discrepancies.
For large migrations, the export process must cover the complete issue population and all relevant historical records. Any filtering or export limitations need to be considered before treating the results as a complete archive.
Atlassian Marketplace: Issue History & Snapshots Reporter for Jira
Why verification should happen before retiring Data Center
After a successful migration, organizations naturally want to decommission their Data Center infrastructure.
However, once the original environment is unavailable, investigating historical discrepancies becomes much more difficult.
An independent pre-migration export provides a reference that remains available even after the source system has been retired.
It can also help answer questions that arise months or years after migration, particularly when historical issue changes are relevant to audits, operational reviews, or investigations.
This is why historical verification should be part of migration planning rather than an afterthought.
Conclusion
Jira Cloud Migration Assistant is designed to migrate issue history, but organizations with important historical records may want more than confirmation that the migration completed.
They may want evidence that the information they depend on was preserved.
Exporting issue history before migration and comparing it with the history available afterward provides a practical way to obtain that evidence.
The same principle applies to issue snapshots: comparing issue states before and after migration can provide additional assurance that important field values were preserved.
And there is one particularly important timing consideration:
Perform this verification before decommissioning Jira Data Center.
Once the original environment is gone, investigating historical discrepancies becomes considerably more difficult.
How does your organization verify issue history completeness when migrating Jira Data Center to Cloud?
Disclosure: I am part of the team at Simitech Ltd. that developed and released Issue History & Snapshots Reporter for Jira. The application is mentioned as an example of a tool that can support historical reporting and migration verification. The general approach discussed in this article applies regardless of which tools are used.