adding-your-project-to-a-team.md

title	shortTitle	intro	versions	type	topics	allowTitleToDifferFromFilename	permissions
Adding your {% data variables.projects.project_v2 %} to a team	Adding a {% data variables.projects.project_v2 %} to a team	You can add projects to teams to manage permissions and improve project discoverability.	fpt ghec ghes * * *	tutorial	Projects	true	Organization owners or people with the team maintainer role and admin permissions on a project can add a project to a team.

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 AUTOTITLE.

Adding a project to a team

{% data reusables.profile.access_org %} {% data reusables.user-settings.access_org %} {% data reusables.organizations.specific_team %}

1. Click {% octicon "project" aria-hidden="true" %} Projects.

   

2. Click Link a project.

3. 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, {% data variables.product.github %} will prompt you to confirm your choice.

Removing a project from a team

{% data reusables.projects.project-settings %}

1. Click Manage access.
2. Next to the team that you want to remove from the project, click Remove.

{% ifversion projects-v1 %}

Further reading

• Managing team access to an organization {% data variables.product.prodname_project_v1 %}

{% endif %}