Project Boards

A project board arranges issues and pull requests into columns that represent stages of your workflow, giving the whole team a shared view of what’s in progress, what’s blocked, and what’s done.

Create a Board

Open the repository and select the Projects tab.
Select New Project.
Enter a name for the board.
Choose a starting template — a basic To Do / In Progress / Done layout is a good default — or select an empty board to build the layout from scratch.
Select Create Project to open the board.

Set Up Columns

To add a column, select Add Column, enter a label, and save.
To rename a column, open its settings and choose Edit.
Drag column headers left or right to reorder them.
Mark one column as the default from its settings — any card added without a specific target lands there.

Add and Move Cards

To add an existing issue or pull request, open a column’s menu and select Add an item, then search for it by title or number.
To create a new issue directly on the board, select + inside a column. The issue is saved to the repository and appears as a card immediately.
Drag a card to a different column as work progresses. The card’s position reflects its current status; it doesn’t change the issue’s labels or assignees on its own.

Track Work

The board gives you an at-a-glance picture of your team’s workload without opening individual issues. Keep it current by:

Closing an issue or merging a pull request — the card moves to a done column or leaves the board, depending on your board’s automation settings.
Pairing the board with Milestones when you want a time-boxed goal alongside the Kanban view. Milestones track a due date and completion percentage; the board tracks flow.