Import data to Jira using a CSV file

With the new import experience, you can easily transfer information from other project management tools into Jira, saving time and effort. This page provides instructions on how to import data using a CSV file.

To import data into a new project in Jira 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 or business project.

Upload your CSV file

Upload the CSV file to begin the import. Make sure to prepare and structure your CSV file before uploading and select Next.

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

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?

Set up a new project in Jira

Select a Jira project you’d like to create. You can choose a business or software project. 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. The default Access is Open, and the Key will automatically be selected for you. You can modify the Project name and Key later in the Project Settings. Once you’re done, select Next.

Map project fields

After setting up the project, you will need to map the column data to fields in Jira. Select Next once you’re done. More on how to map data

Custom fields

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

Move users to Jira

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 when you’re done.

Manual vs. auto-population of email addresses

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.

User data when users are not imported

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.

Review project details

In this step, review how your data will be imported into Jira. If you’d like to save a configuration file on your device to use for your next import, select Download a configuration file. Select Import when you’re ready to begin the import.

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