2019-02-18 17:08:36 +00:00
# YouTrack Service
2019-03-22 02:39:00 +00:00
JetBrains [YouTrack ](https://www.jetbrains.com/help/youtrack/standalone/YouTrack-Documentation.html ) is a web-based issue tracking and project management platform.
2019-02-25 11:37:22 +00:00
2019-03-22 02:39:00 +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
2019-03-22 03:54:08 +00:00
## Enable the YouTrack integration
2019-03-22 02:39:00 +00:00
2019-03-22 03:54:08 +00:00
To enable YouTrack integration in a project:
2019-02-18 17:08:36 +00:00
2020-03-30 21:08:01 +00:00
1. Navigate to the project's **Settings > [Integrations](overview.md#accessing-integrations)** page.
2019-03-22 03:54:08 +00:00
1. Click the **YouTrack** service, ensure it's active, and enter the required details on the page as described in the table below.
2019-02-18 17:08:36 +00:00
2019-03-22 03:54:08 +00:00
| Field | Description |
|:----------------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
2020-05-07 00:11:11 +00:00
| **Project URL** | URL to the project in YouTrack which is being linked to this GitLab project. |
| **Issues URL** | 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. |
2019-03-22 02:39:00 +00:00
2019-03-22 03:54:08 +00:00
1. Click the **Save changes** button.
2019-02-18 17:08:36 +00:00
2019-03-22 03:54:08 +00:00
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.
2019-02-18 17:08:36 +00:00
2019-03-22 03:54:08 +00:00
## Disable the internal issue tracker
To disable the internal issue tracker in a project:
1. Navigate to the project's **Settings > General** page.
1. Expand the [permissions section ](../settings/index.md#sharing-and-permissions ) and switch the **Issues** toggle to disabled.
2019-02-18 17:08:36 +00:00
2019-03-22 02:39:00 +00:00
## Referencing YouTrack issues in GitLab
2019-02-18 17:08:36 +00:00
2019-03-22 02:39:00 +00:00
Issues in YouTrack can be referenced as `<PROJECT>-<ID>` . `<PROJECT>`
2019-06-05 06:58:07 +00:00
must start with a letter and is followed by letters, numbers, or underscores.
`<ID>` is a number. An example reference is `YT-101` , `Api_32-143` or `gl-030` .
2019-02-18 17:08:36 +00:00
2019-03-22 03:54:08 +00:00
References to `<PROJECT>-<ID>` in merge requests, commits, or comments are automatically linked to the YouTrack issue URL.
2019-03-22 02:39:00 +00:00
For more information, see the [External Issue Tracker ](../../../integration/external-issue-tracker.md ) documentation.
