Importing Data from JSON
JSON files are easy to read and encapsulate more structure and information than CSV files.
The JSON import feature allows you to import issues from an external (issue tracking) system which:
- JIRA does not provide a dedicated import tool for and
- Can export its data in a JSON format.
You may also wish to prepare your JSON file manually.
Please note that the import format used by the JIRA Importers plugin is more basic than the import format available when using the JIRA REST API.
On this page:
Creating a JSON file for Import
If your current issue tracking system is unable to export in the JSON format, you may wish to create the file manually. To prepare the JSON file, you should use the standard JSON format, and follow the pattern detailed below.
The JSON Importers plugin supports custom fields. Below is a list of custom fields that come bundled with JIRA. If you have installed any additional plugins that have custom fields, these fields will also be supported, however they are not included in this list.
The custom field example below shows some syntax for adding custom fields, including an example of a cascading custom field. If the custom field is not listed above, the "fieldType" can be obtained from the Custom Fields configuration page, by inspecting the source HTML. The "value" is specific to each custom field, and you can find this by inspecting the Edit Issue page's source HTML.
Specific JSON File Examples
Further specific JSON file examples include:
|Users||This example covers a full user. In this example, two groups have been specified. If a group does not exist already, the JIRA Importers plugin will create it.|
|Project Key and Issue Key||You can assign a key to both the project and the issue. These keys can be different. This example will create a project with one issue, "SAM-123".|
|Comments||This example shows how you can import multiple comments for an issue.|
|This example shows the syntax to import worklog detail.|
|Component||Components can be specified in a JSON file in two ways, by providing a name, or by providing an object. This example shows both. The JIRA Importers plugin will always create a new component with "Default Assignee" switched to "Project Default", as you are unable to specify a "Default Assignee".|
|Issues with Time Tracking||Time Tracking detail can be imported with an issue. This example shows you an issue with Time Tracking detail. The "originalEstimate", "timeSpent", and "estimate" values must be in Period format (Format ISO_8601 - Durations). The "startDate" value accepts both the DateTime and Period format.
Please ensure Time Tracking is enabled in JIRA before you start your import, otherwise the data will be ignored by the JIRA Importers plugin during the import.
Running the JSON File Import Wizard
Before you begin: If your JIRA installation has existing data — Back up your existing JIRA data.
- Log in to JIRA as as a user with the JIRA Administrators global permission.
- Choose > System. Select Import & Export > External System Import to open the Import external projects page.
Keyboard shortcut: g + g + start typing external system import
- Select the Import from JSON button associated with the JSON option to open the JSON File import page.
- Choose your JSON file.
- Click the Begin Import button when you are ready to begin importing your JSON file into JIRA. The importer will display updates as the import progresses, then a success message when the import is complete.
Note: If you experience problems with the import (or you are just curious), click the download a detailed log link to view detailed information about the JSON file import process. This information can also be useful if you encounter any errors with your import.
Congratulations! You have successfully imported your JSON projects into JIRA! If you have any questions or encounter any errors, please contact Atlassian support.
Was this helpful?
Thanks for your feedback!