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.

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, select your profile photo, then click Your organizations.

  2. Click the name of your organization.

  3. Under your organization name, click Teams.

    Screenshot of the horizontal navigation bar for an organization. A tab, labeled with the people icon and "Teams," is outlined in dark orange.

  4. Click the name of the team.

  5. Click Projects.

    Screenshot of the main page for a team. In the horizontal navigation bar, the "Projects" tab is outlined in dark orange.

  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.

    Screenshot showing a project's menu bar. The menu icon is highlighted with an orange outline.

  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.

Further reading