YouTrack Server
 
2019.2
Get YouTrack Standalone
You are viewing the documentation for an earlier version of YouTrack Server. View this page in the current documentation
  1. Administration
  2. Integrations
  3. Import from Jira

Import from Jira

Last modified: 17 December 2019

YouTrack lets you connect to a Jira instance. This integration lets you perform the following tasks:

  • Import existing projects, users, groups, and group memberships from Jira.

  • Update previously imported projects to apply changes to issues that were made in Jira. New issues and changes that are applied to issues in the Jira project since the last import are added to YouTrack.

The visibility setting for issues that are imported from Jira with a configured Security Level is set to the Project Admins group.

This integration also imports user accounts that are stored in the Jira instance. The same values for users who created, updated, added comments to, and are assigned issues in Jira are set to the corresponding user accounts in YouTrack.

warning

License Limitations

References to users in Jira issues are mapped to existing accounts in YouTrack. If a match is not found, a new user account is created.

Imported users are allocated a license according to your subscription plan. For users that exceed your per-user license limit, the imported users are flagged as banned.

For more information, see Ban User Accounts.

User accounts that are imported from Jira contain logins and passwords from the Jira instance. To let users log in to YouTrack with their Jira credentials, enable the Jira authentication module. For more information, Atlassian Jira Auth Module.

Prerequisites

Before you import projects from Jira to YouTrack, check the following requirements:

  • The projects that you want to import were created in Jira version 5 or later.

  • Your Jira instance allows remote API calls.

  • Your user account in Jira has administrative permissions. If you connect to the Jira instance with an account that is not assigned an administrator role, you cannot import groups and related data.

Connect to a Jira Instance

When you connect to a Jira instance, you can import entire projects from Jira to YouTrack. The import includes all of the issues that are assigned to the project as well as the user accounts for users who have access to the project, the project roles, groups, and group memberships.

To connect to a Jira instance:

tip

Requires permissions: Low-level Admin Write

  1. In the Integrations section of the Administration menu, select Import from Jira.

    Jira integration settings

  2. Enter values for the following settings:

    Setting

    Description

    Base URL

    Enter the URL of the Jira instance.

    Login

    Enter the username of the account that is used to log in to the Jira instance. This account must have administrative privileges in Jira to import projects, users, groups, and related data.

    • For Jira installations, enter the username. Do not enter an email address.

    • For Jira Cloud, you can use an email address as login.

    Password

    Enter the password for the account that is used to log in to the Jira instance.

    For Jira Cloud, create an API token for your Atlassian account and paste it into the input field for the Password setting.

    SSL key

    Select an optional SSL key to establish a secure connection with the Jira instance.

  3. Click the Connect to Jira button.

    • YouTrack connects to the Jira instance using the specified credentials.

    • The URL of the Jira instance is added to the integration settings page.

      Jira import connected

  4. Select the projects that you want to import to YouTrack. To import all projects, leave the default All available projects setting.

    note

    When your user account has limited access to the projects that are imported from Jira, a drop-down menu is displayed under the Projects setting. Expand this menu to view how your access limitations affect the data that is imported into YouTrack.

    For more information, see Access Information.

  5. To enable automatic import, select the Continuous import option. When this option is enabled, YouTrack checks the Jira instance for changes in the selected projects every 10 minutes. Issues that are added or updated since the previous import are processed and updated in YouTrack.

  6. Click the Import issues button. You can also click the Import single issue link to verify the connection to the Jira instance.

    • The selected projects are imported to YouTrack.

      Jira import finished

    • If the user account that you used to connect to the Jira instance has sufficient permissions, users, groups, and related data are also imported.

    • The date of the last import is displayed on the integration settings page.

    • A download link lets you download the import log. Use this option to view and investigate errors that occurred during import.

Access Information

To import all of the data from a Jira project, your user account must have permission to update the corresponding projects and their issues in YouTrack.

When your user account has limited access to the projects that are imported from Jira, a drop-down menu is displayed under the Projects setting.

Expand this menu to view how your access limitations affect the data that is imported into YouTrack. Select each project to see what limitations apply. The following conditions affect how data is imported into YouTrack:

Condition

Limitation

Your account does not have administer projects permission in Jira.

Groups are created to represent Jira roles, but role actors are not imported.

Your account does not have permission to browse projects in Jira.

Issues from these projects are skipped during import.

Your account does not have permission to create issues in the selected Jira project.

The set of values for custom fields only contain values that are used in one or more Jira issues.

Your account does not have permission to view voters and watchers in the selected Jira project.

Issue voters are not imported.

Your account does not have permission to manage the watchers list in the selected Jira project.

Issue watchers are not imported.

Import Options

After the initial import, the following controls are available on the integration settings page:

Control

Description

Edit settings

Opens the integration settings page in edit mode. Use this option to connect to a different Jira instance or update the login credentials.

Import changes

Immediately imports any changes that were made in the selected Jira projects after the previous import.

Clear import

Removes the current integration settings. Jira entity IDs that are attached to imported issues are also removed. Projects, issues, users, and groups that were imported from the connected Jira instance are not affected. If you clear the import settings and connect to the same Jira instance, the issues are re-imported into existing projects with new issue IDs.