2020-10-24 23:57:45 +05:30
---
2022-11-25 23:54:43 +05:30
stage: Manage
2021-10-27 15:23:28 +05:30
group: Integrations
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2020-10-24 23:57:45 +05:30
---
2021-12-11 22:18:48 +05:30
# Custom issue tracker **(FREE)**
2018-03-17 18:26:18 +05:30
2021-12-11 22:18:48 +05:30
You can integrate an [external issue tracker ](../../../integration/external-issue-tracker.md )
with GitLab. If your preferred issue tracker is not listed in the
2022-05-07 20:08:51 +05:30
[integrations list ](../../../integration/external-issue-tracker.md#configure-an-external-issue-tracker ),
2021-12-11 22:18:48 +05:30
you can enable a custom issue tracker.
After you enable the custom issue tracker, a link to the issue tracker displays
on the left sidebar in your project.
## Enable a custom issue tracker
2018-03-17 18:26:18 +05:30
2021-06-08 01:23:25 +05:30
To enable a custom issue tracker in a project:
2018-03-17 18:26:18 +05:30
2022-10-11 01:57:18 +05:30
1. On the top bar, select **Main menu > Projects** and find your project.
2021-12-11 22:18:48 +05:30
1. On the left sidebar, select **Settings > Integrations** .
2021-06-08 01:23:25 +05:30
1. Select **Custom issue tracker** .
1. Select the checkbox under **Enable integration** .
1. Fill in the required fields:
2020-06-23 00:09:42 +05:30
2021-06-08 01:23:25 +05:30
- **Project URL**: The URL to view all the issues in the custom issue tracker.
- **Issue URL**: The URL to view an issue in the custom issue tracker. The URL must contain `:id` .
2021-12-11 22:18:48 +05:30
GitLab replaces `:id` with the issue number (for example,
`https://customissuetracker.com/project-name/:id` , which becomes
`https://customissuetracker.com/project-name/123` ).
2021-06-08 01:23:25 +05:30
- **New issue URL**:
<!-- The line below was originally added in January 2018: https://gitlab.com/gitlab - org/gitlab/ - /commit/778b231f3a5dd42ebe195d4719a26bf675093350 -->
2021-12-11 22:18:48 +05:30
**This URL is not used and an [issue exists](https://gitlab.com/gitlab-org/gitlab/-/issues/327503) to remove it.**
Enter any URL.
2020-06-23 00:09:42 +05:30
2021-12-11 22:18:48 +05:30
1. Optional. Select **Test settings** .
1. Select **Save changes** .
2018-03-27 19:54:05 +05:30
2021-06-08 01:23:25 +05:30
## Reference issues in a custom issue tracker
2018-03-17 18:26:18 +05:30
2021-06-08 01:23:25 +05:30
You can reference issues in a custom issue tracker using:
2020-06-23 00:09:42 +05:30
2021-06-08 01:23:25 +05:30
- `#<ID>` , where `<ID>` is a number (for example, `#143` ).
- `<PROJECT>-<ID>` (for example `API_32-143` ) where:
- `<PROJECT>` starts with a capital letter, followed by capital letters, numbers, or underscores.
- `<ID>` is a number.
2020-06-23 00:09:42 +05:30
2021-06-08 01:23:25 +05:30
The `<PROJECT>` part is ignored in links, which always point to the address specified in **Issue URL** .
We suggest using the longer format (`< PROJECT > -< ID > `) if you have both internal and external issue
trackers enabled. If you use the shorter format, and an issue with the same ID exists in the
internal issue tracker, the internal issue is linked.
