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 a CSV File

The Python Client Library supports importing issues to YouTrack from a CSV file. Virtually, this option enables you importing data from any other issue tracker, which supports export to a CSV file.

Version compatibility note

Current implementation of the Python Client Library and scripts is compatible with YouTrack 3.x+ REST API and Python 2.7. 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 CSV file:

  1. Download the latest version of YouTrack's Python Client Library and unzip it.
  2. Install Python.
  3. Create a mapping file to set the correspondence between source fields in a CSV file and YouTrack issue's attributes. This mapping file should be created in the <unzipped library directory>\python\csvClient directory. For more details about structure of the library, please to the Python Client Library
  4. When a mapping file is created, specify the mapping file in the file:
  5. Import issues from a file to YouTrack running the following command:
    The following command line parameters should be provided:




    Path to the source CSV file.


    The URL of the target YouTrack server.


    YouTrack administrator user name.


    YouTrack administrator password to log in.

Importing Comments

The current format for importing comments is as follows:

That is, any string between commas (i.e. a column) that comes without a name (like field names in the sample above) will be rendered as a comment.
If you want to use any other format, you should modify the script.


In this section you will find examples of CSV file and a mapping file.

CSV File Sample

Mapping File Sample