External issue trackers
- Tier: Free, Premium, Ultimate
- Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
GitLab has its own issue tracker, but you can also configure an external issue tracker per GitLab project. You can then use:
- The external issue tracker with the GitLab issue tracker
- The external issue tracker only
With an external tracker, you can use the format CODE-123
to mention
external issues in GitLab merge requests, commits, and comments where:
CODE
is a unique code for the tracker.123
is the issue number in the tracker.
References are displayed as issue links.
Disable the GitLab issue tracker
To disable the GitLab issue tracker for a project:
- On the left sidebar, select Search or go to and find your project.
- Select Settings > General.
- Expand Visibility, project features, permissions.
- Under Issues, turn off the toggle.
- Select Save changes.
After you disable the GitLab issue tracker:
- If an external issue tracker is configured, Issues is visible on the left sidebar but redirects to the external issue tracker.
- If no external issue tracker is configured, Issues is not visible on the left sidebar.
Configure an external issue tracker
You can configure any of the following external issue trackers:
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support