2020-07-20 21:09:23 +00:00
---
2021-08-02 15:08:56 +00:00
stage: Ecosystem
group: Integrations
2020-11-26 06:09:20 +00:00
info: 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
2020-07-20 21:09:23 +00:00
---
2021-04-23 06:09:39 +00:00
# YouTrack service **(FREE)**
2019-02-18 17:08:36 +00:00
2021-04-23 06:09:39 +00:00
JetBrains [YouTrack ](https://www.jetbrains.com/youtrack/ ) is a web-based issue tracking and project
management platform.
2019-02-25 11:37:22 +00:00
2021-04-23 06:09:39 +00:00
You can configure YouTrack as an
[external issue tracker ](../../../integration/external-issue-tracker.md ) in GitLab.
2019-02-25 11:37:22 +00:00
2021-04-23 06:09:39 +00:00
To enable the YouTrack integration in a project:
2019-03-22 02:39:00 +00:00
2021-04-23 06:09:39 +00:00
1. Go to the [Integrations page ](overview.md#accessing-integrations ).
1. Select **YouTrack** .
1. Select the checkbox under **Enable integration** .
1. 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.
1. Select **Save changes** or optionally select **Test settings** .
2019-02-18 17:08:36 +00:00
2021-04-23 06:09:39 +00:00
After you configure and enable YouTrack, a link appears on the GitLab
project pages. This link takes you to the appropriate YouTrack project.
2019-02-18 17:08:36 +00:00
2021-04-23 06:09:39 +00:00
You can also disable [GitLab internal issue tracking ](../issues/index.md ) in this project.
Learn more about the steps and consequences of disabling GitLab issues in
[Sharing and permissions ](../settings/index.md#sharing-and-permissions ).
2019-03-22 02:39:00 +00:00
2021-04-23 06:09:39 +00:00
## Reference YouTrack issues in GitLab
2019-02-18 17:08:36 +00:00
2021-04-23 06:09:39 +00:00
You can reference issues in YouTrack using `<PROJECT>-<ID>` (for example `YT-101` , `Api_32-143` or `gl-030` ) where:
2019-02-18 17:08:36 +00:00
2021-04-23 06:09:39 +00:00
- `<PROJECT>` starts with a letter and is followed by letters, numbers, or underscores.
- `<ID>` is a number.
2019-03-22 03:54:08 +00:00
2021-04-23 06:09:39 +00:00
References to `<PROJECT>-<ID>` in merge requests, commits, or comments are automatically linked
to the YouTrack issue URL.