doc/user/project/issues/_index.md
{{< details >}}
{{< /details >}}
Issues help you collaborate with your team to plan, track, and deliver work in GitLab. Issues:
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 -->{{< history >}}
work_items_view_preference. Disabled by default. This feature is in beta.work_items_view_preference enabled on GitLab.com in GitLab 17.9 for a subset of users.work_items_view_preference enabled on GitLab.com, GitLab Self-Managed, and GitLab Dedicated in 17.10.work_item_view_for_issues in GitLab 18.1. Enabled on GitLab.com, GitLab Self-Managed, and GitLab Dedicated. Feature flag work_items_view_preference removed.work_item_view_for_issues removed.{{< /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.
{{< history >}}
extensible_reference_filters. Disabled by default.extensible_reference_filters removed.{{< /history >}}
You can reference work items in GitLab Flavored Markdown fields with [work_item:123].
For more information, see GitLab-specific references.