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:

  • Dragging cards from the Triage section in the sidebar.
  • Typing the issue or pull request URL in a card.
  • Searching for issues or pull requests in the project board search sidebar.

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.

Adding issues and pull requests to a repository project board

  1. On GitHub, navigate to the main page of the repository.

  2. Under your repository name, click Projects. Project tab

  3. In the projects list, click the name of the project board. Select project

  4. In your project board, click Add cards. Add cards button

  5. 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."
  6. 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 an organization-wide project board

You can link up to five repositories to your organization 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."

  1. In the top right corner of GitHub, click your profile photo, then click Your profile. Profile photo

  2. On the left side of your profile page, under "Organizations", click the icon for your organization. organization icons

  3. Under your organization name, click Projects. Projects tab for your organization

  4. In the projects list, click the name of the project board. Select project

  5. In your project board, click Add cards. Add cards button

  6. 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."
  7. 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 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