Note: Projects (beta) is currently in public beta and subject to change.
A project is a customizable spreadsheet that integrates with your issues and pull requests on GitHub. You can customize the layout by filtering, sorting, and grouping your issues and PRs. You can also add custom fields to track metadata. Projects are flexible so that your team can work in the way that is best for them.
Your project automatically stays up-to-date with the information on GitHub. When a pull request or issue changes, your project reflects that change. This integration also works both ways, so that when you change information about a pull request or issue from your project, the pull request or issue reflects that information.
You can use custom fields to add metadata to your tasks. For example, you can track the following metadata:
- a date field to track target ship dates
- a number field to track the complexity of a task
- a single select field to track whether a task is Low, Medium, or High priority
- a text field to add a quick note
- an iteration field to plan work week-by-week, including support for breaks
You can view your project as a high density table layout:
Or as a board:
To help you focus on specific aspects of your project, you can group, sort, or filter items:
For more information, see "Customizing your project views."
You can use the project command palette to quickly change views or add fields. The command palette guides you so that you don't need to memorize custom keyboard shortcuts. For more information, see "Customizing your project views."
Projects (beta) offers built-in workflows. For example, when an issue is closed, you can automatically set the status to "Done." You can also use the GraphQL API and GitHub Actions to automate routine project management tasks. For more information, see "Automating projects" and "Using the API to manage projects."
Projects (beta) is a new, customizable version of projects. For more information about the non-beta version of projects, see "Organizing your work with project boards."
You can share your feedback about projects (beta) with GitHub. To join the conversation, see the feedback discussion.