Import issues into an existing space in Jira using CSV
Learn how to import issues into an existing space in Jira using CSV files.
Only site and organization admins and only projects previously migrated via external system import (X2C) are able to use this feature.
Environment
Jira Cloud
Site/Organization Admin permissions required
Important limitations
Only CSV imports are supported for this feature.
Only admins can perform imports, and only from the external system import option in Jira admin settings.
You can’t add new statuses, issue types, custom fields, or custom field options during import. All imported data must match the existing project configuration.
Only projects previously migrated via external system import (X2C) support updates to existing issues.
For bulk updates, the CSV must include the issue key for each issue you want to update.
To import issues into an existing Jira Space
Go to Jira Administration.
Select System then External System Import.
Select CSV as the import source.
Select the existing Space you want to import issues into.
Upload your CSV file.
Map the fields in your CSV file to the fields in your existing Jira Space. All fields, statuses, issue types, and custom fields must already exist in the project.
For updates, ensure the CSV includes the correct issue key for each issue you want to update.
Review the migration summary. If your CSV contains any new statuses, issue types, custom fields, or options, the import will fail. Resolve these conflicts before proceeding.
Start the import process.
After the import completes, review the migration report for any issues or skipped records.
Note:
If your import fails due to configuration conflicts, edit your CSV to remove or correct any new statuses, issue types, custom fields, or options before retrying.
Additional information
Only projects previously migrated via external system import support updates to existing issues.
No new configuration elements can be added during import.
Was this helpful?