How to bulk import Components into Jira Issues
Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.
Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.
*Except Fisheye and Crucible
- Please note that this solution only works when using the CSV import available from the page ⚙ > System > Import & Export > External System Import, which only Jira Administrators can access.
- If you use the CSV import available from the page Issues > Import issues from CSV, the suggestion from the KB article will not work, and components will not be imported due to the error "The component <Component 1> doesn't exist in this project and can't be added"
Summary
This article discusses how you can use the CSV issue import to update components for issue tickets.
Note that, as explained in the panel above, you will need to be a Jira Administrator to be able to implement this solution, since only Jira admin users can access the CSV import from the page ⚙ > System > Import & Export >External System Import.
Environment
Jira 7.x, 8.x, 9.x Data Center and Server
Solution
The in-built CSV Issue Import functionality can be used to bulk-import components into JIRA. This method will only import the Component Names. If you need to add a Component Description as well, you could use the Jira Data Center platform REST API.
Option 1
- Login as a Jira Administrator user
- Select the required Jira project.
Create a temporary issue that you would use for the import. You can provide a summary like "Issue for importing components".
Create a CSV file with multiple lines using the same Issue Key, same Issue Summary, and different Component Names on different lines.
Key,Summary,Components TEST-100,Issue for importing components,New Component 1 TEST-100,Issue for importing components,New Component 2 TEST-100,Issue for importing components,New Component 3 TEST-100,Issue for importing components,New Component 4 TEST-100,Issue for importing components,New Component 5 TEST-100,Issue for importing components,New Component 6 TEST-100,Issue for importing components,New Component 7
- Use the CSV importer from the page ⚙ > System > Import & Export > External System Import to import the CSV file
Map the fields as required and complete the import.
- Delete the temporary issue with the Summary as in the CSV file.
Option 2
Create a CSV file having a single line with the multiple components as this example. In this case it would create a new issue with all the components.
Summary,Component,Component,Component Issue for importing components,New Component 16, New Component 17, New Component 18
- Use the CSV importer from the page ⚙ > System > Import & Export > External System Import to import the CSV file
Map the fields as required and complete the import.
- Delete the temporary issue with the Summary as in the CSV file.