Let's Chat!

Any questions? Contact us by filling out the form below and we will respond within 24 hours.

Other Options
Our team will get back to you as soon as possible.
Oops! Something went wrong while submitting the form.

How to import Gradient issues to Jira


How to export all issues in a Gradient project to a CSV file, and import them to Jira.

Note: This tutorial is based on documentation provided by Jira on how to import CSV files to a Jira project. For more information reference that document here. Scroll down to the section titled "Importing your CSV File"

Step 1: Within a Gradient project, open the options menu at the top of the issues list and select “Export Issues as CSV”:

An arrow pointing at the option the Export Issues as CSV in Gradient so that the file can then be imported into Jira

This will send a CSV file of all issues in the project to your email.

Step 2: In Jira, expand the left side menu and select “Jira Settings”, then “System” and then “External System Import”, as show below. You may need administrative privileges to access the System Settings menu.

The first step in importing a file of issues into Jira from Gradient is to expand the left side menu in Jira

An arrow guiding users to the Jira Settings option in the left side menu of the Jira app

After expanding the Jira settings, the next step is to click on System in the left side panel of the Jira software

expanding the Systems tab opens up a new list of options on the Jira menu where users are guided to click on External System Import

Step 3: Select the CSV import option.

Clicking on External System Import in Jira opens a page that says Jira Import Wizard where users have the option to click on CSV

Step 4: Upload the CSV file that was exported from Gradient and click Next.

On the CSV File Import page of the Jira app, users are guided to click on Choose File to upload their CSV file on Gradient issues

Step 5: Choose the destination project for the Gradient issues, and enter the email domain for any new users that will be created from the import. The Date Format field should not need to be modified.

On the Map Projects Setup page, users are instructed to fill in the Import to Project line with a destination project such as Gradient, and to fill in their email if they are a new user

Step 6: Next, map fields in the CSV to the appropriate fields in Jira. This will be dependent on your exact Jira configuration. You will need to manually “Map Field Value” for the assignee and created_by fields, as usernames in Gradient likely will not line up with Jira. To do this, select the check boxes highlighted below.

on the Map Fields page, users are instructed to check the boxes for 'assignee' and 'created_by' to fill in the map field value manually

Step 7: Here, you’ll need to enter the jira handle of the associated user in the “Target value in Jira” field. A quick way to determine the handle of a certain user in Jira is to open an issue and begin to type their name in the assignee field.

I  contacted Jira support to determine if there was an easier way to view all user’s handles - unfortunately I received the following response:

“We are in the process of changing how Jira handles these mentions, so you can't easily verify them”

On the Map Values page, users have the option of manually typing in the Target Value in JIRA for the CSV fields 'assignee' and 'created_by'

Step 8: Next, map the Gradient statuses to Jira statuses.

On the Map Values page, users are also instructed to map the Value from Importer with the Target Value in JIRA for CSV field 'status', then click 'Begin Import'

Step 9: Finally, click Begin Import to import all the issues to the Jira project.

After importing the CSV file to Jira, users are instructed to click 'Save the configuration' so this process is automated in the future

Like what you read?

Subscribe to our mailing list and receive great content just like this.
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.

CoLab Software

Engineering Review & Issue Tracking, Solved.