GitLab Issues Documentation

The GitLab Issue Tracker is an advanced and complete tool for tracking the evolution of a new idea or the process of solving a problem.

It allows you, your team, and your collaborators to share and discuss proposals, before and while implementing them.

Issues and the GitLab Issue Tracker are available in all GitLab Products as part of the GitLab Workflow.

Use-Cases

Issues can have endless applications. Just to exemplify, these are some cases for which creating issues are most used:

  • Discussing the implementation of a new idea
  • Submitting feature proposals
  • Asking questions
  • Reporting bugs and malfunction
  • Obtaining support
  • Elaborating new code implementations

See also the blog post Always start a discussion with an issue.

Issue Tracker

The issue tracker is the collection of opened and closed issues created in a project.

Issue tracker

Find the issue tracker by navigating to your Project's Dashboard > Issues.

GitLab Issues Functionalities

The image bellow illustrates how an issue looks like:

Issue view

Learn more about it on the GitLab Issues Functionalities documentation.

New Issue

Read through the documentation on creating issues.

Closing issues

Read through the distinct ways to close issues on GitLab.

Create a merge request from an issue

Learn more about it on the GitLab Issues Functionalities documentation.

Search for an issue

Learn how to find an issue by searching for and filtering them.

Advanced features

Confidential Issues

Whenever you want to keep the discussion presented in a issue within your team only, you can make that issue confidential. Even if your project is public, that issue will be preserved. The browser will respond with a 404 error whenever someone who is not a project member with at least Reporter level tries to access that issue's URL.

Learn more about them on the confidential issues documentation.

Issue templates

Create templates for every new issue. They will be available from the dropdown menu Choose a template when you create a new issue:

issue template

Learn more about them on the issue templates documentation.

Crosslinking issues

Learn more about crosslinking issues and merge requests.

GitLab Issue Board

The GitLab Issue Board is a way to enhance your workflow by organizing and prioritizing issues in GitLab.

Issue board

Find GitLab Issue Boards by navigating to your Project's Dashboard > Issues > Board.

Read through the documentation for Issue Boards to find out more about this feature.

Multiple Issue Boards are available only in GitLab Enterprise Edition.

Issue's API

Read through the API documentation.