Issues

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 GitLab blog post: Always start a discussion with an issue.

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.

To learn how the GitLab Strategic Marketing department uses GitLab issues with labels and issue boards, see the video on Managing Commitments with Issues.

Issues as work items

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 blog post First look: The new Agile planning experience in GitLab (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

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

Related topics

• Create issues
• Create an issue from a template
• Edit issues
• Move issues
• Close issues
• Delete issues
• Promote issues
• Set a due date
• Import issues
• Export issues
• Upload designs to issues
• Linked issues
• Similar issues
• Health status
• Cross-link issues
• Sort issue lists
• Search for issues
• Epics
• Issue boards
• Issues API
• Configure an external issue tracker
• Tasks
• View count and weight of tasks in an issue
• View progress of an issue with child tasks
• External participants