VOOZH about

URL: https://docs.github.com/en/issues/planning-and-tracking-with-projects/managing-your-project/adding-your-project-to-a-team

⇱ Adding your project to a team - GitHub Docs

Skip to main content

Adding your project to a team

You can add projects to teams to manage permissions and improve project discoverability.

Who can use this feature?

Organization owners or people with the team maintainer role and admin permissions on a project can add a project to a team.

In this article

About adding projects to teams

You can add projects to your team to give the whole team collaborator access to their projects. When you add a project to a team, that project is listed on the team's projects page, making it easier for members to identify which projects a particular team uses.

Teams are granted read permissions on any project they are added to. This permission is added to existing permissions for the project and for individual team members, ensuring that any higher permissions are retained. For more information about setting permissions for teams and individual contributors, see Managing access to your projects.

Adding a project to a team

  1. In the upper-right corner of GitHub, click your profile picture, then click Organizations.

  2. Click the name of your organization.

  3. Under your organization name, click Teams.

  4. Click the name of the team.

  5. Click Projects.

  6. Click Link a project.

  7. In the search field, start typing the name of the project you want to add and then select the project in the list of matches.

    Note

    If this change will result in increased project permissions for the team's members, GitHub will prompt you to confirm your choice.

Removing a project from a team

  1. Navigate to your project.

  2. In the top-right, click to open the menu.

  3. In the menu, click Settings to access the project settings.

  4. Click Manage access.

  5. Next to the team that you want to remove from the project, click Remove.