GitHub Issues · Project planning for developers · GitHub
Skip to content
GitHub Issues

GitHub Issues

Create issues, break them into sub-issues, track progress, add custom fields, and have conversations. Visualize large projects as tables, boards, or roadmaps, and automate everything with code.

Start using projectsContact sales
The image shows a project management dashboard for "OctoArcade Invaders." It is divided into three sections: "Prototype," "Beta," and "Launch." Each section lists tasks with their status, assignees, and progress. Tasks are labeled as "Complete," "In Progress," or "Not Started," with corresponding icons and progress bars indicating completion percentages.

Logos for Shopify, Vercel, Stripe, Ford, and NASA

Manage complex work from start to finish

Break issues into sub-issues

Tackle complex issues with sub-issues and track their status with progress indicators. Navigate the full scope of work all in one view.

The image shows a project management interface with tasks and issues listed. The background is purple, and there are three overlapping task cards. The top card has a green "Open" status label and is titled "Task: Updates to aliens and cannon game logic." The middle card has a purple "Closed" status label and is titled "Update collision logic." The bottom card, which is the most detailed, has a green "Open" status label and is titled "New rendering engine #920." It includes comments from a user named 'carlawonders' who commented 5 days ago about follow-up work on the new rendering engine. There are sub-issues listed under this task, including Intelligent Chatbot Support, User profiling and segmentation, User interface design for AI integration, Real-time tracking of user behavior and preferences, and Documentation and user guides

Streamline conversations

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

The image shows a project management interface with a teal to purple gradient background. At the top, there is a green "Open" label and "3 tasks" listed under the heading "Improve alien character controls." Below this, there are three task cards. The first card is from user rajqflow, posted 5 days ago, discussing feedback from testers about sprite animations and tagging users @inesvibe, @hanksolo, and @chieda to share the beta tester report. The second card is from user inesvibe, posted 5 days ago, announcing that they have published the report with a link to octocoradeo/testerlist#13. The third card is from user khayrizen again, posted 4 days ago, mentioning dark mode support for UI #179588.

Projects that adapt to the way you work

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

The image shows a task management board with a dark theme. It is divided into columns for Assignees, Labels, and Cycles. Each row lists an assignee's name, the label associated with their task (such as "Bug," "Need help," "Design," or "Back-end"). There is dropdown menu expanded under the "cycle" column that shows different data types. The data types are "Text", "Number", "Date", "Single select", and iteration. "Text" is currently selected. The board is used to track tasks assigned to different individuals and their current status.

Bored of boards? Switch to tables and roadmaps. Create views for how you work.

Save views for sprints, backlogs, teams, or releases. Rank, group, sort, slice and filter to suit the occasion.

Organize work your way. Create swimlanes, share templates, and set work-in-progress limits to match your team's workflow.

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.

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 GodfreyDevelopment Manager

Flexible project planning for developers

Start using projectsContact sales

Issues, where you need them

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.

GitHub Copilot CLI

Use Copilot CLI to search, summarize, update, and implement GitHub issues directly from the command line.

Frequently Asked Questions

What is GitHub Issues?

We all need a way to plan our work, track issues, and discuss 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 unique 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 emojis, clarify with attachments and videos, plus reference code like commits, pull requests, and deploys. With task lists, you can break big issues into tasks, further organize your work with milestones and labels, and track relationships and dependencies.

We built GitHub Issues for developers. It is simple, adaptable, and powerful.

What are Projects?

As teams and projects grow, how we work evolves. Tools that hard-code a methodology are too specific and rigid to adapt to any moment. Often, we find ourselves creating a spreadsheet or pulling out a notepad to have the space to think. Then our planning is disconnected from where the work happens.

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.

What plans have access to Projects?

All users have access to the free tier of GitHub Issues and Projects. For more information about paid tiers, see our pricing page.

Will the new Projects experience be available in GitHub Enterprise Server?

Yes! GitHub Enterprise Server (GHES) support follows our regular cadence of one to two quarters before enabling the on-premises functionality.