Article version: GitHub.com

Adding issues and pull requests to a project board

You can add issues and pull requests to a project board in the form of cards and triage them into columns.

You can add issue or pull request cards to your project board by:

Cursor moves issue card from triaging sidebar to project board column

Note: You can also add notes to your project board to serve as task reminders, references to issues and pull requests from any repository on GitHub, or to add related information to your project board. For more information, see "Adding notes to a project board."

You can view and make lightweight edits to issues and pull requests within your project board by clicking on the issue or pull request's title.

You can link up to five repositories to your organization or user-owned project board to make it easier to add issues and pull requests from those repositories to your project board. When you search for issues and pull requests to add to your project board, the search automatically scopes to your linked repositories. You can remove these qualifiers to search within all organization repositories. For more information, see "Linking a repository to a project board."

Adding issues and pull requests to a project board

  1. Navigate to the project board where you want to add issues and pull requests.

  2. In your project board, click Add cards.

    Add cards button

  3. Search for issues and pull requests to add to your project board using search qualifiers. For more information on search qualifiers you can use, see "Searching issues."

    Search issues and pull requests

    Tips:

    • You can also add an issue or pull request by typing the URL in a card.
    • If you're working on a specific feature, you can apply a label to each related issue or pull request for that feature, and then easily add cards to your project board by searching for the label name. For more information, see "Apply labels to issues and pull requests."
  4. From the filtered list of issues and pull requests, drag the card you'd like to add to your project board and drop it in the correct column. Alternatively, you can move cards using keyboard shortcuts. For more information about keyboard shortcuts, see "Project boards" in "Using keyboard shortcuts."

    Tip: You can drag and drop or use keyboard shortcuts to reorder cards and move them between columns. For more information about keyboard shortcuts, see "Project boards" in "Using keyboard shortcuts."

Adding issues and pull requests to a project board from the sidebar

  1. On the right side of an issue or pull request, click Projects .
    Project board button in sidebar
  2. Click the Recent, Repository,User, or Organization tab for the project board you would like to add to.
    Recent, Repository and Organization tabs
  3. Type the name of the project in Filter projects field.
    Project board search box
  4. Select one or more project boards to add the issue or pull request as a pending card.
    Selected project board
  5. On the right side of an issue or pull request, click PROJECT-BOARD-NAME (awaiting triage).
    Link to project board
  6. In your project board, click Add cards (1 new).
    Add cards button
  7. Drag the card for your issue or pull request from the Triage section, to the desired column on the project board. Alternatively, you can move cards using keyboard shortcuts. For more information about keyboard shortcuts, see "Project boards" in "Using keyboard shortcuts."

Further reading

Ask a human

Can't find what you're looking for?

Contact us