Linking a repository to a project (classic)

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

Note

Creation of new projects (classic) is now disabled. Projects (classic) will be sunset and removed on August 23, 2024. You can read more about this change on the GitHub Blog.

The new and improved Projects experience is available. For more information, see "About Projects."

On August 23, 2024, all remaining projects (classic) will be automatically migrated before the feature is removed.

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

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

  2. On the top-right side of the project (classic), click Menu.

  3. Click , then click Settings.

    Screenshot showing the project menu. The settings option is highlighted with an orange outline.

  4. In the left sidebar, click Linked repositories.

  5. Click Link a repository.

  6. Search for the repository you'd like to link.

  7. Click Link. To unlink, click Unlink.

Note: In order to link a repository to your organization or user owned project (classic) 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."

Further reading