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 > Issues.

Sidebar showing menu items under the project header, such as “Manage” and “Plan.” Under the plan header is the “Issues” link.

A list of all open issues appears:

A listing of issues, each one with its own title. There is, additionally, two buttons in the upper-right, “Bulk edit” and “New item”

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, select New item.

The New Issue dialog has the fields “Type”, “Title”, and “Description”, as well as several additional fields in a sidebar, “Assignee”, “Labels”, “Milestone”, “Dates”, and “Contacts.”

  1. Select the Type of the issue, or use the default, Issue.
  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. You may additionally 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.

The listing of issues now contains the previously created issue in the previous example image, which was titled “My New Issue.”

Next steps

Next you can: