Tutorial: Create an issue in an existing project

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

An issue tracks a task, problem, or planned feature in your project. Issues are used to plan work and ask for help. Issues can track any task, not just bugs or problems.

Learn how to view all the open issues in your project, and create a new one to report a problem you noticed.

Open the issues list

First, browse through the open issues the project. This way, you can see if there is an existing issue for the problem you noticed.

In your project, in the left sidebar, select Plan > Work items.

Sidebar showing the “Manage” and “Plan” menu items under the project header. Under the plan header, the “Work items” link is highlighted.

In the filter bar, select the filter Type, operator is, and value Issue. A list of all open issues appears:

A list of issues sorted by Created date. The tabs “All items” and “+ Add view” are visible in the upper-left. A vertical ellipsis control is in the top-right, next to a “New items” button

Create a new issue

You don’t find any existing issues that describe the bug you noticed, so in this step, you’ll create a new one.

In the upper-right corner, select New item.

The New Issue dialog shows the fields “Type”, “Title”, and “Description.” Additional sidebar fields such as “Assignee”, “Labels”, “Milestone”, and “Dates” are also shown.

  1. From the Type dropdown list, select Issue if it is not already selected.
  2. Give your new issue a title to summarize it.
  3. Add a description of the work to be performed, the idea to be transcribed, or the bug you found.
  4. If you know who in the project should be assigned this task, set the Assignee field. Select assign yourself if you intend to work on this issue.
  5. Optional. Select labels to better categorize your issue.
  6. Select a milestone if applicable.
  7. Optional. Fill in the Dates fields to specify when this task is intended to begin and end.
  8. Optional. Set the Contacts to tag additional team members or stakeholders who should be consulted on this task.
  9. Select Create issue to finish creating the new issue. The revised issue list appears with the new issue included.

Next steps

Next you can: