How to import Gradient issues to Jira

Product

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.