1
0
mirror of synced 2025-12-19 18:10:59 -05:00
Files
docs/content/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-repository.md
John Clement 25cb3e0536 Improved projects onboarding flow [GA] (#58155)
Co-authored-by: Laura Coursen <lecoursen@github.com>
2025-11-06 17:55:32 +00:00

2.6 KiB
Raw Permalink Blame History

title, shortTitle, intro, versions, type, topics, allowTitleToDifferFromFilename
title shortTitle intro versions type topics allowTitleToDifferFromFilename
Adding your {% data variables.projects.project_v2 %} to a repository Adding a {% data variables.projects.project_v2 %} to a repo You can add your {% data variables.projects.project_v2 %} to a repository to make it accessible from that repository.
fpt ghec ghes
* * *
tutorial
Projects
true

Linking a repository to your project

You can list relevant projects in a repository. You can only list projects that are owned by the same user or organization that owns the repository.

In order for repository members to see a project listed in a repository, they must have visibility for the project. For more information, see AUTOTITLE and AUTOTITLE.

  1. On {% data variables.product.prodname_dotcom %}, navigate to the main page of your repository.
  2. Click {% octicon "table" aria-hidden="true" aria-label="table" %} Projects. Screenshot showing a repository's tabs. The "Projects" tab is highlighted with an orange outline.
  3. Click Link a project.
  4. In the search bar that appears, search for projects that are owned by the same user or organization that owns the repository.
  5. Click on a project to list it in your repository.

{% ifversion project-default-repositories %}

Setting a default repository for your project

You can set a default repository for a project. When you set a default repository, new issues created from your project are automatically assigned to that repository. After you set a default repository, your project also appears in the repositorys Projects tab.

To update the default repository for your project:

  1. In your repository, click {% octicon "table" aria-hidden="true" aria-label="table" %} Projects.
  2. Under "Projects," find and click your project in the list.
  3. In the top-right of the project page, click the {% octicon "kebab-horizontal" aria-label="repository settings" %} dropdown menu, then select {% octicon "gear" aria-label="Settings" %} Settings to go to the project settings page. Screenshot showing the location of the "Settings" button in the project menu, highlighted with a red outline.
  4. Under "Default repository," select a default repository for your project.
  5. Click Save changes to confirm your changes.{% endif %}