YouTrack Service

JetBrains YouTrack is a web-based issue tracking and project management platform. Please refer official documentation for details about YouTrack itself.

  1. To enable the YouTrack integration in a project, navigate to the Integrations page, click the YouTrack service, and fill in the required details on the page as described in the table below.

    Field Description
    description A name for the issue tracker (to differentiate between instances, for example)
    project_url The URL to the project in YouTrack which is being linked to this GitLab project
    issues_url The URL to the issue in YouTrack project that is linked to this GitLab project. Note that the issues_url requires :id in the URL. This ID is used by GitLab as a placeholder to replace the issue number.

    Once you have configured and enabled YouTrack you'll see the YouTrack link on the GitLab project pages that takes you to the appropriate YouTrack project.

  2. To disable the internal issue tracking system in a project, navigate to the General page, expand Permissions, and slide the Issues switch invalid.

    Issue configuration

Referencing issues in YouTrack

Issues in YouTrack can be referenced as <PROJECT>-<ID> where <PROJECT> starts with a capital letter which is then followed by capital or lower case letters, numbers or underscores, and <ID> is a number (example Api_32-143).

<PROJECT> part is included into issue_id and links can point any YouTrack project (issues_url + issue_id)