Your project can track draft issues, issues, and pull requests.
Note: A project can contain a maximum of 1,200 items and 10,000 archived items.
Adding issues and pull requests to a project
Pasting the URL of an issue or pull request
- Place your cursor in the bottom row of the project, next to the .
- Paste the URL of the issue or pull request.
- To add the issue or pull request, press Return.
Searching for an issue or pull request
- Place your cursor in the bottom row of the project, next to the .
- Enter #.
- Select the repository where the pull request or issue is located. You can type part of the repository name to narrow down your options.
- Select the issue or pull request. You can type part of the title to narrow down your options.
Bulk adding issues and pull requests
- In the bottom row of the project, click .
- Click Add item from repository.
- Optionally, to change the repository, click the dropdown and select a repository. You can also search for specific issues and pull requests.
- Select the issues and pull requests you want to add.
- Click Add selected items.
Adding multiple issues or pull requests from a repository
- On GitHub.com, navigate to the repository that contains the issues or pull requests you want to add to your project.
- Under your repository name, click Issues or Pull requests.
- To the left of each issue title, select the issues that you want to add to your project.
- Optionally, to select every issue or pull request on the page, at the top of the list of issues or pull requests, select all.
- Above the list of issues or pull requests, click Projects.
- Click the projects you want to add the selected issues or pull requests to.
Assigning a project from within an issue or pull request
- Navigate to the issue or pull request that you want to add to a project.
- In the side bar, click Projects.
- Select the project that you want to add the issue or pull request to.
- Optionally, populate the custom fields.
Using the command palette to add an issue or pull request
- To open the project command palette, press Command+K (Mac) or Ctrl+K (Windows/Linux).
- Start typing "Add items" and press Return.
- Optionally, to change the repository, click the dropdown and select a repository. You can also search for specific issues and pull requests.
- Select the issues and pull requests you want to add.
- Click Add selected items.
Creating draft issues
Draft issues are useful to quickly capture ideas. Unlike issues and pull requests that are referenced from your repositories, draft issues exist only in your project.
- Place your cursor in the bottom row of the project, next to the .
- Type your idea, then press Enter.
- To add body text, click on the title of the draft issue. In the markdown input box that appears, enter the text for the draft issue body, then click Save.
Draft issues can have a title, text body, assignees, and any custom fields from your project. In order to populate the repository, labels, or milestones for a draft issue, you must first convert the draft issue to an issue. For more information, see "Converting draft issues to issues."
Note: Users will not receive notifications when they are assigned to or mentioned in a draft issue unless the draft issue is converted to an issue.