Back to Gitlabhq

Issues

doc/user/project/issues/_index.md

18.11.25.7 KB
Original Source

{{< details >}}

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

Issues help you collaborate with your team to plan, track, and deliver work in GitLab. Issues:

  • Track feature proposals, tasks, support requests, and bug reports.
  • Organize and prioritize work with assignees, due dates, and health status.
  • Facilitate team discussion and decision-making through comments and threaded discussions.
  • Support custom workflows through templates, labels, epics, and boards.
  • Integrate with external tools like Zoom, Jira, and email services.

For more information about issues, see the always start a discussion with an issue blog post.

Issues are always associated with a specific project. If you have multiple projects in a group, you can view all of the projects' issues at once.

<div class="video-fallback"> See the video: <a href="https://www.youtube.com/watch?v=Mt1EzlKToig">Issues - Setting up your Organization with GitLab</a>. </div> <figure class="video-container"> <iframe src="https://www.youtube-nocookie.com/embed/Mt1EzlKToig" frameborder="0" allowfullscreen> </iframe> </figure> <!-- Video published on 2023-10-30 -->

<i class="fa-youtube-play" aria-hidden="true"></i> To learn how the GitLab Strategic Marketing department uses GitLab issues with labels and issue boards, see the managing commitments with issues video.

<!-- Video published on 2020-04-10 -->

Issues as work items

{{< history >}}

{{< /history >}}

We have changed how issues look by migrating them to a unified framework for work items to better meet the product needs of our Agile Planning offering.

For more information, see epic 9290 and the new Agile planning experience in GitLab blog post. (June 2024).

If you run into any issues while trying out this change, you can use the feedback issue to provide more details.

Work item Markdown reference

{{< history >}}

{{< /history >}}

You can reference work items in GitLab Flavored Markdown fields with [work_item:123]. For more information, see GitLab-specific references.