Skip to content
Must-have
In Progress
Priority
Bug
Planning
Bug
Needs review
Complete
Back-end
User story
Ready for review
In progress
Required
To-do
Concept art
Bug
In QA
Front-end

Project planning for developers

Create issues, break them into tasks, track relationships, add custom fields, and have conversations. Visualize large projects as spreadsheets or boards, and automate everything with code.

Beta

Bored of boards?
Switch to tables.

Built like a spreadsheet, project tables give you a live canvas to filter, sort, and group issues and pull requests. Tailor them to your needs with custom fields and saved views.

Board view: Project cards in a classic kanban board layout. Cards are sorted in 4 columns based on their status, in a view called 'Standup.' Table view: Project cards in a table layout. Cards are listed as line items, like a spreadsheet. Cards are grouped by three project phases in a view called 'The Plan.'
Board view: Project cards in a classic kanban board layout. Cards are sorted in 4 columns based on their status, in a view called 'Standup.'
Used by companies like…
  • Shopify
  • Vercel
  • Stripe
  • Ford
  • NASA

Break issues into actionable tasks

Tackle complex issues with task lists and track their status with new progress indicators. Convert tasks into their own issues and navigate your work hierarchy.

Move conversations forward

Express ideas with GitHub Flavored Markdown, mention contributors, react with emoji, clarify with attachments, and see references from commits, PRs, releases, and deploys. Coordinate by assigning contributors and teams, or by adding them to milestones and projects. All in a single timeline.

  • Upload and attach videos to comments
  • Dive into work faster with issue forms and templates
  • Upload and attach videos to comments
  • Dive into work faster with issue forms and templates
Beta

Create views
for how you work

Save views for sprints, backlogs, teams, or releases. Rank, group, sort, and filter issues to suit the occasion. Choose between tables, boards, and timelines (coming soon).

Illustration of project table view with cards grouped by 'Feature planning' phase. Illustration of project table view with cards grouped by 'Feature planning' phase.
Beta

Work at keyboard speed

No mouse? No problem. Every action you can take with the mouse has a keyboard shortcut or command. Filter, sort, group, and assign issues. Your hands never leave the keyboard.

Beta

Extend issues
with custom fields

Track metadata like iterations, priority, story points, dates, notes, and links. Add custom fields to project tables and edit from the issue sidebar.

Now with iteration cycle planning

Alpha

Tailor reports from any field

Make any field reportable. Track the progress of your current iteration cycle, milestone, or visualize bottlenecks and issues blocking the team with the new project insights.

Beta

Manage work automatically

Accelerate your project planning with automations. Automatically triage issues, set values for custom fields, react to changes, or schedule something. You can even combine them to run an Action.

Issues, wherever you look

Issues can be viewed, created, and managed in your browser, your favorite terminal, or on your phone or iPad.

Use the command line interface to check the issues assigned to you, mentioning you, and opened by you in your current repo.
# Viewing issues relevant to you
~/Projects/my-project $ gh issue status
 
Issues assigned to you
  #42 Updates to game background (epic:fork, meta)
 
Issues mentioning you
  #94 Game logic (alien, cannon, score)
  #11 Tweak difficulty level based on Alpha feedback
 
Issues opened by you
  #89 Integrate with game engine
  #56 Documentation and support (enhancement)
 
~/Projects/my-project $

GitHub CLI

View, update, and create issues without ever leaving your terminal.

GitHub Mobile

Create and manage issues on the go with our native iOS and Android mobile apps.

The new planning and tracking functionality keeps my project management close to my code. I no longer find myself needing to reach for spreadsheets or 3P tools which go stale instantly.
Dan Godfrey Development Manager Shopify

Frequently asked questions

Why GitHub Issues?

We all need a way to plan our work, track issues, and talk about the things we build. Our answer to this universal question is GitHub Issues, and it’s built-in to every repository. GitHub’s issue tracking is special because of our focus on simplicity, references, and elegant formatting.

With GitHub Issues you can express ideas with GitHub Flavored Markdown, assign and mention contributors, react with emoji, clarify with attachments and videos, plus reference code like commits, pull requests, and deploys. With task lists you can break big issues into tasks, and then further organize your work with milestones and labels, and track relationships and dependencies.

We built GitHub issues for developers. It is simple, flexible, and powerful.

Why project tables and boards?

As teams and projects grow, how we work evolves. Tools that hard-code a specific methodology are too specific and rigid to flex to whatever the moment demands. Often, we find ourselves creating a spreadsheet or pulling out a notepad, just to have the space to think. But then our planning is disconnected from where the work happens and quickly goes stale.

The new Projects connect your planning directly to the work your teams are doing, and flexibly adapt to whatever your team needs at any point. Built like a spreadsheet, project tables give you a live canvas to filter, sort, and group issues and pull requests. You can use it, or the accompanying project board, along with custom fields, to track a sprint, plan a feature, or manage a large-scale release.

I am in the Beta, where do I share feedback?

You can share your experience with us using discussions in our feedback repository. We look forward to hearing your thoughts.

How much will the new GitHub Issues cost?

Our plan is to continue to bundle GitHub Issues and its new project planning capabilities in our Free, Pro, Team, and Enterprise plans at no additional cost.

Will the Beta be available in GitHub Enterprise Server?

GitHub Enterprise Server support follows our normal cadence of one to two quarters before we enable the functionality on-premises.

How does this co-exist with other features like the existing kanban boards?

Once the Beta is enabled on your account, the organization's projects page will display both projects (classic kanban) and the new beta projects (with table and custom field) side by side. They will coexist through the beta period, with classic projects automatically updating to leverage the new features prior to general availability.

It is important to note that at this time there are no migration tools available, both from existing projects or other planning and tracking tools.

How can I create a new project at the repo level?

Projects can be created at either the organization or user level, once created you can easily add your project to the existing projects tab within a repository. Allowing you to keep it even closer to your code.

What is on the roadmap for the new GitHub Issues?

We are really excited to start this journey with all of you.

Our roadmap towards general availability (GA) will evolve, but expect improvements to the core flows and new functionality to be continuously added. Top features include:

  1. Built in hierarchy and task-list support
  2. Issue level custom fields that expand repositories (labels, milestones, etc.)
  3. A new project timeline to plan and track work

Flexible project planning for developers