Before you begin: Ensure REST API is enabled in the target YouTrack installation before starting import process. This setting is located on Administration > Settings screen (http://<your YouTrack instance>/settings). 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.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 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 csv2youtrack.py file:
5. Import issues from a file to YouTrack running the following command:

   The following command line parameters should be provided:

   Parameter	Description
   target_host	The URL of the target Youtrack server.
   target_login	YouTrack administrator user name.
   target_password	YouTrack administrator password to log in..
   project_id	YouTrack Project ID.
   project_name	YouTrack Project Name
   path_to_csv_file	Path to the source CSV file.