Jira CSV Import Format
To import issues into Jira using a CSV file, you need to follow a specific format. The CSV file should have the following columns:
Summary
: A brief summary of the issue.Issue Type
: The type of issue (e.g., Bug, Task, Story).Description
: A detailed description of the issue.Priority
: The priority of the issue (e.g., High, Medium, Low).Assignee
: The person assigned to work on the issue.Reporter
: The person who reported the issue.Labels
: Any labels or tags associated with the issue.Components
: The components or modules related to the issue.Affects Version/s
: The versions of the software affected by the issue.Fix Version/s
: The versions of the software in which the issue is fixed.Environment
: The environment in which the issue occurs.Due Date
: The due date for the issue.Original Estimate
: The original time estimate for the issue.Remaining Estimate
: The remaining time estimate for the issue.Logged Time
: The time logged against the issue.Link
: Any links or references related to the issue.
Note: The column headers are case-sensitive and should be an exact match to the ones mentioned above. You can leave any optional columns blank if not applicable.
Here's an example of how a CSV file for Jira issue import might look:
mathematicaSummary,Issue Type,Description,Priority,Assignee,Reporter,Labels,Components,Affects Version/s,Fix Version/s,Environment,Due Date,Original Estimate,Remaining Estimate,Logged Time,Link
Fix login page,Bug,"The login page is not displaying properly.",High,John,Doe,UI,Authentication,1.0,1.1,Production,,2h,1h,1h,
Implement new feature,Task,"Implement a new feature for user management.",Medium,Jane,Smith,,User Management,2.0,,Development,,4h,2h,,
Make sure to save the file in CSV format (.csv) and ensure that the data in each column is correctly aligned.
Sure! Here's an example of the CSV data for importing 10 issues (5 tasks and 5 stories) into a Jira project with the key "TM" and the reporter set as "jens@released.so":
sqlSummary,Issue Type,Description,Priority,Assignee,Reporter,Labels,Components,Affects Version/s,Fix Version/s,Environment,Due Date,Original Estimate,Remaining Estimate,Logged Time,Link
Design app logo,Task,"Create a visually appealing logo for the app.",Medium,Anna,jens@released.so,Design,UI/UX,1.0,1.1,Design Studio,,4h,3h,2h,
Implement user authentication,Task,"Add user authentication functionality to the app.",High,John,jens@released.so,Security,Backend,1.0,1.1,Development,,8h,5h,3h,
Write user documentation,Task,"Prepare comprehensive user documentation for the app.",Low,Sarah,jens@released.so,Documentation,,1.0,1.1,Documentation,,6h,4h,2h,
Test app performance,Task,"Perform performance testing on the app.",High,Mark,jens@released.so,Testing,QA,1.0,1.1,Testing Environment,2023-07-15,10h,8h,6h,
Fix broken links,Task,"Identify and fix broken links in the app.",Medium,Emma,jens@released.so,Quality,Frontend,1.0,1.1,Production,,6h,4h,3h,
Implement task management feature,Story,"Allow users to create and manage tasks in the app.",High,John,jens@released.so,Feature,Task Management,1.0,1.1,Development,,12h,10h,8h,
Design app interface,Story,"Design an intuitive user interface for the app.",High,Anna,jens@released.so,UI/UX,UI Design,1.0,1.1,Design Studio,,16h,14h,12h,
Implement notifications,Story,"Add push notifications for task updates.",Medium,Mark,jens@released.so,Notification,Backend,1.0,1.1,Development,,10h,8h,6h,
Improve search functionality,Story,"Enhance the app's search feature for better user experience.",Medium,Sarah,jens@released.so,Search,Frontend,1.0,1.1,Production,,8h,6h,4h,
Create user onboarding flow,Story,"Develop a user onboarding process to guide new users.",Low,Emma,jens@released.so,Onboarding,UI/UX,1.0,1.1,Design Studio,,14h,12h,10h,
Please note that this is a sample data representation, and you can modify it as per your specific requirements for the task management application.
Certainly! Here's an updated version of the CSV data where the time tracking values are represented in seconds:
sqlSummary,Issue Type,Description,Priority,Assignee,Reporter,Labels,Components,Affects Version/s,Fix Version/s,Environment,Due Date,Original Estimate,Remaining Estimate,Logged Time,Link
Design app logo,Task,"Create a visually appealing logo for the app.",Medium,Anna,jens@released.so,Design,UI/UX,1.0,1.1,Design Studio,,14400,10800,7200,
Implement user authentication,Task,"Add user authentication functionality to the app.",High,John,jens@released.so,Security,Backend,1.0,1.1,Development,,28800,18000,10800,
Write user documentation,Task,"Prepare comprehensive user documentation for the app.",Low,Sarah,jens@released.so,Documentation,,1.0,1.1,Documentation,,21600,14400,7200,
Test app performance,Task,"Perform performance testing on the app.",High,Mark,jens@released.so,Testing,QA,1.0,1.1,Testing Environment,2023-07-15,36000,28800,21600,
Fix broken links,Task,"Identify and fix broken links in the app.",Medium,Emma,jens@released.so,Quality,Frontend,1.0,1.1,Production,,21600,14400,10800,
Implement task management feature,Story,"Allow users to create and manage tasks in the app.",High,John,jens@released.so,Feature,Task Management,1.0,1.1,Development,,43200,36000,28800,
Design app interface,Story,"Design an intuitive user interface for the app.",High,Anna,jens@released.so,UI/UX,UI Design,1.0,1.1,Design Studio,,57600,50400,43200,
Implement notifications,Story,"Add push notifications for task updates.",Medium,Mark,jens@released.so,Notification,Backend,1.0,1.1,Development,,36000,28800,21600,
Improve search functionality,Story,"Enhance the app's search feature for better user experience.",Medium,Sarah,jens@released.so,Search,Frontend,1.0,1.1,Production,,28800,21600,14400,
Create user onboarding flow,Story,"Develop a user onboarding process to guide new users.",Low,Emma,jens@released.so,Onboarding,UI/UX,1.0,1.1,Design Studio,,50400,43200,36000,
In this updated version, the time estimates and logged time are represented in seconds rather than hours.
To import a CSV file in Jira, you can follow these steps:
- Log in to your Jira account with appropriate permissions.
- Navigate to the project where you want to import the issues.
- Click on the "Settings" gear icon in the top-right corner and select "System" from the dropdown menu.
- In the left sidebar of the System page, under the "IMPORT AND EXPORT" section, click on "External System Import."
- On the External System Import page, click on the "CSV" tab.
- Choose the CSV file you want to import by clicking on the "Choose File" or "Browse" button.
- Specify the import settings:
- Map the CSV columns to Jira fields by selecting the appropriate fields from the dropdown menus.
- Configure additional options such as issue linking, duplicate handling, and more based on your requirements.
- Once you have configured the import settings, click on the "Begin Import" button to start the import process.
- Jira will validate the CSV data and display a summary of the import. Review the summary to ensure everything looks correct.
- If everything looks good, click on the "Import" button to initiate the import process.
- Jira will import the data from the CSV file and create the issues in the specified project. The progress of the import will be displayed.
- Once the import is complete, you will receive a notification, and you can view the imported issues in your project.
Please note that the import process may vary slightly depending on the version of Jira you are using or any custom configurations set up by your Jira administrator. It's always a good practice to review the Jira documentation or consult your Jira administrator for specific instructions tailored to your Jira instance.