Skip to main content

This version of GitHub Enterprise Server was discontinued on 2024-09-25. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

Adding items to your project

Learn how to add pull requests, issues, and draft issues to your projects individually or in bulk.

Note: A project can contain a maximum of 1,200 items and 10,000 archived items. To learn more about automatically archiving items when they meet specific criteria, see "Archiving items automatically."

Adding issues and pull requests to a project

You have several options for adding issues and pull requests to your project. You can add them individually, automatically, or in bulk. Furthermore, you can include issues and pull requests from any organization, and you also have the ability to add draft issues that can be converted into regular issues later on. For more information, see "Creating draft issues."

For more information about making bulk changes to your items after adding them, see "Editing items in your project."

Automatically adding issues and pull requests

You can configure a built-in workflow to automatically add issues and pull requests from a repository when they meet specific filter criteria. For more information about configuring a workflow, see "Adding items automatically."

Pasting the URL of an issue or pull request

You can copy the URL of an issue or pull request into your clipboard and paste that into your project.

  1. Place your cursor in the bottom row of the project, next to the .

    Screenshot showing the bottom row of a table view. The "Add item" field is highlighted with an orange outline.

  2. Paste the URL of the issue or pull request.

  3. To add the issue or pull request, press Return.

Searching for an issue or pull request

If you know the issue or pull request number or if you know part of the title, you can search for an issue or pull request directly from your project.

  1. Place your cursor in the bottom row of the project, next to the .

    Screenshot showing the bottom row of a table view. The "Add item" field is highlighted with an orange outline.

  2. To open the list of repositories, type #.

  3. Select the repository where the pull request or issue is located. You can type part of the repository name to narrow down your options.

  4. Select the issue or pull request. You can type part of the title to narrow down your options.

Bulk adding issues and pull requests

You can add multiple issues and pull requests from your project and use filters, such as label:bug, to narrow down your search.

  1. In the bottom row of the project, click .

    Screenshot showing the bottom row of a table view. The "+" button is highlighted with an orange outline.

  2. Click Add item from repository.

  3. Optionally, to change the repository, click the dropdown and select a repository. You can also search for specific issues and pull requests.

    Screenshot showing the "Add from repository" form. The repository dropdown and search field are highlighted with an orange outline.

  4. Select the issues and pull requests you want to add.

  5. Click Add selected items.

Adding multiple issues or pull requests from a repository

You can also add issues and pull requests to your project from a repository's issue and pull request lists.

  1. On GitHub, navigate to the repository that contains the issues or pull requests you want to add to your project.

  2. Under your repository name, click Issues or Pull requests.

    Screenshot of the main page of a repository. In the horizontal navigation bar, two tabs, labeled "Issues" and "Pull requests," are each outlined in dark orange.

  3. Select the issues or pull requests you want to add to your project.

    • To select individual issues or pull requests, to the left of the title of each issue or pull request you want to add to your project, select the checkbox.

      Screenshot of the first two issues in the list of issues for a repository. To the left of each issue, a checkbox is outlined in dark orange.

    • To select every issue or pull request on the page, at the top of the list of issues or pull requests, select all.

      Screenshot of the list of issues for a repository. In the header above the list, a checkbox to select all issues is outlined in dark orange.

  4. Above the list of issues or pull requests, click Projects.

  5. Click the projects you want to add the selected issues or pull requests to.

Assigning a project from within an issue or pull request

You can also add an issue or pull request to your project from within the issue or pull request itself.

  1. Navigate to the issue or pull request that you want to add to a project.
  2. In the side bar, click Projects.
    Screenshot showing an issue's sidebar. "Projects" is highlighted with an orange outline.
  3. Select the project that you want to add the issue or pull request to.
  4. Optionally, populate the custom fields.

Using the command palette to add an issue or pull request

You can use the command palette when viewing your project to quickly add items.

  1. To open the project command palette, press Command+K (Mac) or Ctrl+K (Windows/Linux).

  2. Start typing "Add items" and press Return.

  3. Optionally, to change the repository, click the dropdown and select a repository. You can also search for specific issues and pull requests.

    Screenshot showing the "Add from repository" form. The repository dropdown and search field are highlighted with an orange outline.

  4. Select the issues and pull requests you want to add.

  5. Click Add selected items.

Creating issues

You can quickly create issues without leaving your project. When using a view that is grouped by a field, creating an issue in that group will automatically set the new issue's field to the group's value. For example, if you group your view by "Status", when you create an issue in the "Todo" group, the new issue's "Status" will automatically be set to "Todo."

  1. At the bottom of a table, group of items, or a column in board layout, click .

    Screenshot showing the bottom row of a table view. The "+" button is highlighted with an orange outline.

  2. Click Create new issue.

  3. At the top of the "Create new issue" dialog, select the repository where you want the new issue to be created.

    Screenshot showing the "Create new issue" dialog.

  4. Below the repository dropdown, type a title for the new issue.

  5. Optionally, use the fields below the title field to set assignees, labels, and milestones, and add the new issue to other projects.

  6. Optionally, type a description for your issue.

  7. Optionally, if you want to create more issues, select Create more and the dialog will reopen when you create your issue.

  8. Click Create.

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.

  1. Place your cursor in the bottom row of the project, next to the .

    Screenshot showing the bottom row of a table view. The "Add item" field is highlighted with an orange outline.

  2. Type your idea, then press Enter.

  3. 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.