2020-10-29 11:09:12 -04:00
---
stage: none
group: unassigned
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/#designated-technical-writers
---
2014-04-24 18:48:22 -04:00
# External issue tracker
2020-10-19 23:08:54 -04:00
GitLab has a great [issue tracker ](../user/project/issues/index.md ) but you can also use an external
one. External issue trackers are configurable per GitLab project.
2014-01-24 06:09:33 -05:00
2019-03-21 23:54:08 -04:00
Once configured, you can reference external issues using the format `CODE-123` , where:
- `CODE` is a unique code for the tracker.
- `123` is the issue number in the tracker.
These references in GitLab merge requests, commits, or comments are automatically converted to links to the issues.
2015-02-18 23:49:19 -05:00
2019-03-21 22:39:00 -04:00
You can keep GitLab's issue tracker enabled in parallel or disable it. When enabled, the **Issues** link in the
GitLab menu always opens the internal issue tracker. When disabled, the link is not visible in the menu.
2017-07-24 02:14:06 -04:00
2015-02-12 20:06:55 -05:00
## Configuration
2020-10-19 23:08:54 -04:00
The configuration is done via a project's **Settings > Integrations** .
2015-02-12 20:06:55 -05:00
2020-03-30 17:08:01 -04:00
### Integration
2015-02-12 20:06:55 -05:00
2020-03-30 17:08:01 -04:00
To enable an external issue tracker you must configure the appropriate **Integration** .
2016-01-08 06:43:33 -05:00
Visit the links below for details:
2015-02-12 20:06:55 -05:00
2017-02-03 13:41:35 -05:00
- [Bugzilla ](../user/project/integrations/bugzilla.md )
2017-11-21 10:21:50 -05:00
- [Custom Issue Tracker ](../user/project/integrations/custom_issue_tracker.md )
2020-10-19 23:08:54 -04:00
- [Engineering Workflow Management ](../user/project/integrations/ewm.md )
- [Jira ](../user/project/integrations/jira.md )
- [Redmine ](../user/project/integrations/redmine.md )
- [YouTrack ](../user/project/integrations/youtrack.md )
2015-02-12 20:06:55 -05:00
### Service Template
2020-10-19 23:08:54 -04:00
To avoid configuring each project's service individually, GitLab provides the ability to set
Service Templates. These can then be overridden in each project's settings.
2015-04-26 19:44:22 -04:00
2017-02-03 13:41:35 -05:00
Read more on [Services Templates ](../user/project/integrations/services_templates.md ).
