gitlab-org--gitlab-foss/doc/user/project/integrations/youtrack.md

stage	group	info
Ecosystem	Integrations	To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/engineering/ux/technical-writing/#assignments

YouTrack service (FREE)

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 top bar, select Menu > Projects and find your project.
2. On the left sidebar, select Settings > Integrations.
3. Select YouTrack.
4. Select the checkbox under Enable integration.
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. Select Save changes or optionally select Test settings.

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. Learn more about the steps and consequences of disabling GitLab issues in Sharing 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.