GitHub Projects V2 — Label-Based Column Automation

How to add a visual kanban board on top of an existing label-based workflow without changing any code.

Why / When to Use

When you already use labels (e.g. status:dev, status:qa) to drive GitHub Actions, and want a board view that automatically reflects those labels as column positions.

Core Concept

Option A (recommended for existing label workflows): Add a Project V2 board that mirrors label changes via built-in column automation. Zero code changes to existing Actions.

Label added → existing Action runs → board column updates automatically.

Setup Steps

1. Go to repo → Projects tab → New Project → choose Board template
2. Create columns: Todo | Dev | QA | Review | Done
3. For each column: click ... → Workflows → Add workflow
4. Set rules:
   • “Item added to project” → move to Todo
   • “Label added: status:dev” → move to Dev
   • “Label added: status:qa” → move to QA
   • etc.
5. Add existing issues to the board

Key Options / Variants

Option B — Drive from board status (no labels):

on:
  projects_v2_item:
    types: [edited]  # fires when card moves between columns

Requires GitHub Projects V2, more complex event parsing, may need paid plan for private repos.

Gotchas

• Option A requires no code changes — the board is purely a visual layer
• Column automation in Projects V2 uses built-in rules (no Actions YAML needed)
• “Item added to project” rule must be set manually per column — it doesn’t auto-apply

Source

Conversation: “Auto - GitHub Action” — 2026-05-29