Note: Projects (beta) is currently in limited public beta. For more information, see GitHub Issues.
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
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 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) is a new, customizable version of projects. Projects (beta) is currently only available to a limited number of beta users. The non-beta version of projects is available to all users. To learn more about the beta, see GitHub Issues. 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.