To enable the Custom Issue Tracker integration in a project:
- Go to Settings > Integrations.
- Click Custom Issue Tracker
Fill in the tracker’s details, such as title, description, and URLs. You will be able to edit these fields later as well.
These are some of the required fields:
Field Description Project URL The URL to the project in the custom issue tracker. Issues URL The URL to the issue in the issue tracker project that is linked to this GitLab project. Note that the
:idin the URL. This ID is used by GitLab as a placeholder to replace the issue number. For example,
New issue URL Currently unused. Will be changed in a future release.
- Click Test settings and save changes.
After you configure and enable the Custom Issue Tracker service, you’ll see a link on the GitLab project pages that takes you to that custom issue tracker.
Issues are referenced with
<ANYTHING>-<ID> (for example,
<ANYTHING> can be any string in CAPS, and
is a number used in the target project of the custom integration.
<ANYTHING> is a placeholder to differentiate against GitLab issues, which are referenced with
#<ID>. You can use a project name or project key to replace it for example.
When building the hyperlink, the
<ANYTHING> part is ignored, and links always point to the address
issues_url, so in the example above,
PROJECT-143 would refer to