Introducing the GitLab Issue Board

The perfect pairing of issue tracking and project management

Watch a GitLab demo Documentation

What is the GitLab Issue Board?

One tool, endless functionality

Everything is in one place. Track issues and communicate progress without switching between products. One interface to follow your issues from backlog to done.

Beautiful and comprehensive

It’s more than a visual representation. It’s your issues, your labels, and all the metadata that comes with them. And you still have all of the same sorting and filtering tools that you use across GitLab.

Flexible setup

You define your process and we organize it. You create the label. We create the corresponding column and pull in your existing issues. When you're ready you drag and drop from one step to the next.

Check out the Issue Board in action

Watch our webcast!

Lean more about the Issue Board and see the rest of GitLab 8.11
Watch on YouTube

Getting started with your Issue Board

The GitLab Issue Board is available in GitLab.com, GitLab Community Edition, and GitLab Enterprise Edition.
Getting started is the same in all three products (except step 6).

[ step 01 ]

Create a New Issue

Issues help you summarize your ideas and align the team on a common goal.

Go to the Issues tab under your project's page and create your first issue.

If your project already has some issues, jump right to the next step!

[ step 02 ]

Label your issue

Labels make it easy to categorize issues based on descriptive titles. They help teams quickly understand the context of an issue. Labels can be used to describe the issue type, like "new feature," or describe the issue stage, like "QA."

Create your first label: it's simple, you can create it from within the issue itself or by navigating to the labels area.

If you already have labels, it's time to meet the Issue Board!

[ step 03 ]

Navigate to your Issue Board

Issues appear as cards on the Issue Board.
They can be arranged across a number of columns using lists.

Find your Issue Board by navigating to your project's Issues > Board. By default, there's a list called Backlog, where you'll find all the issues in that project, and there's a list called Done, which will contain all the issues that have already been closed. Now let's create some new lists.

[ step 04 ]

Create a new list

Lists are based on the labels already created for your project.
Each list contains the issues that are assigned to the corresponding label.

Click "Create new list" and choose a label to create the list from. Once done, the list will appear as a new column on your board, and the issues assigned to that label will automatically move from Backlog to your new list. If you are starting fresh, you can add GitLab's suggested default lists to your Issue Board in one click.

Once you have created your lists, you can drag-and-drop to re-order them to match your team's flow.

[ step 05 ]

Move issues between lists

Communicate progress on your release and easily adjust your plans right from the Issue Board.

Move an issue between two lists and the label will swap to the new list.

Every time you create a new issue with any of the labels in your lists or you create a new issue right from the Board, the issue will be automatically displayed on your Issue Board.

When you're done working, simply move the card to Done and the issue will be automatically closed for you!

[ step 06 ]

Multiple Project Issue Boards

Create multiple Issue Boards for each of your projects.

It's simple: navigate to your Issue Board, click to open a dropdown menu that will give you the option to create new boards, edit the existing ones, or delete the boards you don't need anymore. Use the same dropdown menu to navigate between your boards.

[ step 07 ]

Group Issue Boards

Multiple Group Issue Board functionality is available only in GitLab Silver/Premium and Gold/Ultimate and GitLab.com.

Create Issue Boards at the group level and manage all issues of the underlying projects in a single and concentrated view.

Lists, labels, and milestones are all managed at the group level, allowing you to focus on the group. This means a team may naturally be working across multiple projects, making it extremely helpful to manage issues across all those projects together.

Interested in multiple Issue Boards per group? Download a free trial of GitLab Enterprise Edition risk-free for 30 days!

Take GitLab for a spin

See what your team could do with The DevSecOps Platform.

Get free trial

Have a question? We're here to help.

Talk to an expert
Edit this page View source