Custom Issue Tracker Service

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

FieldDescription
titleA title for the issue tracker (to differentiate between instances, for example).
descriptionA name for the issue tracker (to differentiate between instances, for example)
project_urlThe URL to the project in the custom issue tracker.
issues_urlThe URL to the issue in the issue tracker 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. For example, https://customissuetracker.com/project-name/:id.
new_issue_urlCurrently unused. Will be changed in a future release.

Once you have configured and enabled Custom Issue Tracker Service you’ll see a link on the GitLab project pages that takes you to that custom issue tracker.

Referencing issues

  • Issues are referenced with ANYTHING-<ID>, where ANYTHING can be any string and <ID> is a number used in the target project of the custom integration (example PROJECT-143).
  • 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.
  • So with the example above, PROJECT-143 would refer to https://customissuetracker.com/project-name/143.