A one-time importer to bring Jira issues, associated metadata, and users (optional) into Zenhub. Available for new and trial users only.

How to Export Data from Jira

To export your data from Jira, follow these steps:

  1. Select your projects.
  2. Select Export from the “Share” menu.
  3. Choose the All Fields option.


Data Imported into Zenhub

When you import data from Jira, the following information is brought into Zenhub:

  • Issue title
  • User assignees and authors
  • Epics
  • Subtasks
  • Status
  • Pipeline names
  • Estimates
  • Comments


How to Create Users in Zenhub from Your Data

If you replace the Jira username in the CSV with the user’s email, Zenhub will create a user for them. You can then invite that user to the Zenhub organization.


Importing Data into Zenhub

To import your data into Zenhub, follow these steps:

  1. Navigate to "Edit workspace" in the left side panel.

  2. Scroll down to "Import" and select "Import Jira issues via .csv."

    [NOTE]: This option is only available when editing an existing workspace, not when creating a new one.

  3. You will be brought to the import tab. Please note the file size limit is 20MB.

  4. Drag a file directly into the window or click "browse" to select the file you wish to import.

  5. Once you've selected a file to import, a data scan will show how many Epics, issues, subtasks, and users have been found.


Tips for Using the Zenhub CSV Importer

To get the most out of the Zenhub CSV importer, consider these key points:

  • Limit Your Data: Focus on importing the most important information. Use Jira filters to select high-priority issues.
  • Export All Fields: Ensure you select the “All Fields” option when exporting your data to get the most comprehensive information.
  • Replace Display Names with Email Addresses: Jira exports may include display names instead of email addresses. Swap out display names with email addresses in the CSV to ensure proper user assignment in Zenhub.
  • Import Users: Use the Jira admin panel to export user data. This can be done via the gear icon > User Management > Export Users. This provides a list of users with display names and email addresses.


Example Script for Replacing Display Names with Email Addresses

Here is an example ChatGPT prompt that can be used to quickly generate a script to replace display names in the Jira issue export with email addresses:


Prompt:


I have two CSV files I exported from Jira. The file “/Users/yourname/Downloads/export-users.csv” contains a list of users, one user per row, you’ll find columns for their User id, User name, and their email addresses. The other file is “/Users/yourname/Downloads/export-issues.csv” and it contains a list of all of the issues from a Jira Project. Please write a python script that replaces every “User name” and “User id” in the export-issues.csv file with the corresponding email address that matches. Save the changes to a new csv file.”




FAQ

Q: How do I filter which issues to export from Jira?

A: Use Jira’s filtering options to select high-priority or specific issues. This helps in focusing on the most important tasks during the import process.

Q: What if the CSV contains display names instead of email addresses?

A: You can manually replace the display names with email addresses in the CSV file. Alternatively, use a script provided in the Zenhub Help Center to automate this process.

Q: Who can perform the Jira data export?

A: Only Jira administrators can export user data. If you are not an admin, you will need to request assistance from one.