2020-10-29 15:09:12 +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-10-29 15:09:12 +00:00
---
2021-02-17 18:09:19 +00:00
# External issue tracker **(FREE)**
2014-04-24 22:48:22 +00:00
2022-03-17 12:07:26 +00:00
GitLab has an [issue tracker ](../user/project/issues/index.md ), but you can
configure an external issue tracker per GitLab project.
2014-01-24 11:09:33 +00:00
2022-03-17 12:07:26 +00:00
After you configure the external tracker, you can reference external issues
in GitLab merge requests, commits, and comments
using the format `CODE-123` , where:
2019-03-22 03:54:08 +00:00
- `CODE` is a unique code for the tracker.
- `123` is the issue number in the tracker.
2022-03-17 12:07:26 +00:00
The references are automatically converted to links to the issues.
2015-02-19 04:49:19 +00:00
2020-12-16 03:09:46 +00:00
You can keep the GitLab issue tracker enabled in parallel or disable it. When enabled, the **Issues** link in the
2019-03-22 02:39:00 +00:00
GitLab menu always opens the internal issue tracker. When disabled, the link is not visible in the menu.
2017-07-24 06:14:06 +00:00
2022-03-17 12:07:26 +00:00
## Configure an external issue tracker
2015-02-13 01:06:55 +00:00
2022-03-17 12:07:26 +00:00
To enable an external issue tracker, you must configure the appropriate [integration ](../user/project/integrations/index.md ).
2015-02-13 01:06:55 +00:00
2022-03-17 12:07:26 +00:00
The following external issue tracker integrations are available:
2015-02-13 01:06:55 +00:00
2017-02-03 18:41:35 +00:00
- [Bugzilla ](../user/project/integrations/bugzilla.md )
2017-11-21 15:21:50 +00:00
- [Custom Issue Tracker ](../user/project/integrations/custom_issue_tracker.md )
2020-10-20 03:08:54 +00:00
- [Engineering Workflow Management ](../user/project/integrations/ewm.md )
2021-05-12 09:10:19 +00:00
- [Jira ](../integration/jira/index.md )
2020-10-20 03:08:54 +00:00
- [Redmine ](../user/project/integrations/redmine.md )
- [YouTrack ](../user/project/integrations/youtrack.md )
2022-03-17 12:07:26 +00:00
- [ZenTao ](../user/project/integrations/zentao.md )