Skip to content


DETAILS: Tier: Free, Premium, Ultimate Offering: SaaS, self-managed

JetBrains YouTrack is a web-based issue tracking and project management platform.

You can configure YouTrack as an external issue tracker in GitLab.

To enable the YouTrack integration in a project:

  1. On the left sidebar, select Search or go to and find your project.
  2. Select Settings > Integrations.
  3. Select YouTrack.
  4. Under Enable integration, select the Active checkbox.
  5. Fill in the required fields:
    • Project URL: The URL to the project in YouTrack.
    • Issue URL: The URL to view an issue in the YouTrack project. The URL must contain :id. GitLab replaces :id with the issue number.
  6. Optional. Select Test settings.
  7. Select Save changes.

After you configure and enable YouTrack, a link appears on the GitLab project pages. This link takes you to the appropriate YouTrack project.

You can also disable GitLab internal issue tracking in this project. For more information about the steps and consequences of disabling GitLab issues, see Configure project visibility, features, and permissions.

Reference YouTrack issues in GitLab

You can reference issues in YouTrack using <PROJECT>-<ID> (for example YT-101, Api_32-143 or gl-030) where:

  • <PROJECT> starts with a letter and is followed by letters, numbers, or underscores.
  • <ID> is a number.

References to <PROJECT>-<ID> in merge requests, commits, or comments are automatically linked to the YouTrack issue URL.