Icon header

Introducing the GitLab Issue Board

The perfect pairing of issue tracking and project management

View Blog Post Watch Video

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.

[ 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 1 illustration
[ step 02 ]

Label your issue

Labels make it easy to 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."

Step 2 illustration

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 some 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 3 illustration
[ 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.

Step 4 illustration

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 by dragging and dropping issues from one column to another.

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 you used in your lists, the issue will be automatically displayed on your Issue Board. If you move it to Done, the issue will be automatically closed for you!

Step 5 illustration

Try GitLab Enterprise Edition risk-free for 30 days.

No credit card required. Have questions? Contact us.

Get Your Free Trial Today

Try GitLab Enterprise Edition risk-free for 30 days.

No credit card required. Have questions? Contact us.