Import data to Jira using a CSV file

With the CSV importer, you can easily transfer information from other project management tools into Jira, saving time and effort.

To import data into a new software project using a CSV file:

1. From the navigation bar, select Projects > Create project > Import data on the sidebar.

   • You can also navigate to the page through your settings. Select Settings (⛭) > System > External System Import on the sidebar.

2. Select the app from which you’d like to import your data from. If you can’t find your app in the list, select CSV to use any CSV file to import your data.

   • If you select Asana, ClickUp, monday, or Trello, you can directly import data without a CSV file. Read about directly importing data from Asana, ClickUp, monday, or Trello into a software project.

3. Upload your CSV file. Select Next.

   • If you selected an app in the previous step, follow the directions provided to export a CSV file from the app.

   • If you selected CSV, prepare and structure your CSV file and review parent-child mapping before uploading.

   • You can also upload a configuration file under Upload a configuration file to bring in preferences from a previous import. What is a configuration file?

4. Set up a new project in Jira. Select the Jira project (business or software). If you select a software project, you’ll also need to select a template. The available templates are Kanban and Scrum. Select Show more to change your Project type, Access, and Key. Once you’re done, select Next.

   • The default Access is Open.

   • The Key will automatically be selected for you. You can modify the Project name and Key later in the Project Settings.

5. After setting up the project, map the column data to Jira fields. Read how to map data

   • Each row of the CSV file will be created as an issue in your new Jira project.

   • To create custom fields, select the dropdown next to a listed CSV column, select Create a new custom field, and select a custom field type. More about custom fields

   • Select Next once you’re done.

6. Move users into your new project by adding a valid email address for each user to import their information into Jira. You can also choose not to add users in this step. Select Next once you’re done.

   • If your CSV has email addresses in columns containing user information, they will be automatically populated.

   • If you’re manually adding email addresses, make sure to provide the correct email information for each user to avoid data loss and to import the right users into your project.

   • If you choose not to import users, user fields such as assignee and reporter will be unassigned, user @mentions in comments will be converted to plain text, and commenter names will be displayed as Anonymous.

   • Product admins can only add existing users from the site. To add new users, contact an organization admin to invite them before proceeding with the import. Any information of new users added on this page by product admins will not be imported.

7. Review how your data will be imported into Jira.

   • Select Download a configuration file if you’d like to save a configuration file on your device to use for your next import.

   • Select Import when you’re ready to begin the import.

Once the data is imported, the issues will appear in board view.