Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
� 

� 

This version of GitHub Enterprise was discontinued on 2023-01-18. 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. For help with the upgrade, contact GitHub Enterprise support.

Linking a repository to a project board

You can link a repository to your organization's or personal account's project board.

Anyone with write permissions to a project board can link repositories owned by that organization or personal account to the project board. For more information, see "Project board permissions for an organization" or "Permission levels for user-owned project boards."

You can link up to twenty-five repositories to your organization or user-owned project board. Linking repositories makes it easier to add issues and pull requests from those repositories to your project board using Add cards or from the issue or pull requests sidebar. You can add issues and pull requests from any unlinked repositories by typing the issue or pull request URL in a card. For more information, see "Adding issues and pull requests to a project board."

  1. Navigate to the project board where you want to link a repository.
  2. On the top-right side of the project board, click Menu.
  3. Click , then click Settings. Settings option in drop-down menu from project board sidebar
  4. In the left sidebar, click Linked repositories. Linked repositories menu option in left sidebar
  5. Click Link a repository. Link a repository button on Linked repositories tab
  6. Search for the repository you'd like to link. Search field on Link a repository window
  7. Click Link. To unlink, click Unlink. Link button

Note: In order to link a repository to your organization or user owned project board the repository needs to have issues enabled. That is, the repository has an "Issues" tab (in forked repositories issues are disabled by default). For information on how to enable or disable issues for a repository, see "Disabling issues for a repository."

Further reading