Skip to main content

Linking a repository to a project (classic)

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

Notes:

  • Projects, the all-new projects experience, is now available. For more information about Projects, see "About Projects" and for information about migrating your classic project, see "Migrating from Projects (classic)."
  • You can only create a new classic project board for an organization, user, or repository that already has at least one classic project board. If you're unable to create a classic project board, create a project board instead.

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

You can link up to twenty-five repositories to your organization or user-owned classic project. Linking repositories makes it easier to add issues and pull requests from those repositories to your classic project 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 (classic)."

  1. Navigate to the classic project where you want to link a repository.
  2. On the top-right side of the classic project, 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 classic project 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