You are viewing documentation for the older version of YouTrack!

Skip to end of metadata
Go to start of metadata

Before you begin:


If you try to re-import same project several times, then you must delete previously imported data before the next attempt.

Importing Issues from Jira

Version compatibility note

Current implementation of the Python Client Library and scripts is compatible with YouTrack 3.x and 4.x REST API and Python 2.6. If you use YouTrack 2.x, please refer to YouTrack Release Downloads Archive for the YouTrack 2.x compatible versions of the library and scripts.

To import issues from an existing Jira 5.x server:

  1. Download the latest version of YouTrack's Python Client Library and unzip it.
  2. Install Python.
  3. Take a look at the file located in the <unzipped library directory>\python\jira directory. This mapping file defines correspondence between source fields in Jira project and the type of YouTrack issue's attributes, to which these fields should be converted. In general, this default mapping file is enough for the import, however if you feel the default mapping is not sufficient for your particular usecase, you may edit it. For more details about structure of the library, please to the Python Client Library
  4. Import issues from your Jira installation to YouTrack running the following command:
    The following command line parameters should be provided:




    URL of the source Jira server


    Jira administrator user name.


    Jira administrator password to log in.


    The URL of the target Youtrack server.


    YouTrack administrator user name.


    YouTrack administrator password to log in..


    Project ID of a project in Jira to be imported. In YouTrack a project with the same projectID will be created.


    Number of issues to import from the source Jira project


    Number of issues in the source project to skip before import. Optional parameter.

For example:
To import 1234 issues from the PRJ project in the "" Jira installation to YouTrack InCloud instance, use the following command:

  • No labels