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.

2. From the sidebar, go to More > select Import data.

3. 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.

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

4. Upload your CSV file. Select Next.

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

   2. If you selected CSV, prepare and structure your CSV file for import before uploading it.

5. 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.

   1. The default Access is Open.

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

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

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

   2. 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

   3. Select Next once you’re done.

7. 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.

8. Review how your data will be imported into Jira and select Import.

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